{ "info": { "name": "Elastic Path Commerce APIs", "description": "Complete API collection for Elastic Path Commerce Cloud, generated from OpenAPI specifications", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_postman_id": "29dc9a35-4716-46a0-9fd1-512d2037d5b6" }, "item": [ { "name": "Accounts", "description": "An Account represents the entity that participates in a Commerce transaction. Accounts can have Carts, Orders, Subscriptions, and Addresses.\n", "item": [ { "id": "a5fcacb6-e5b2-403d-9e21-59d2291eafed", "name": "Create an Account", "request": { "name": "Create an Account", "description": { "content": "With the account creation endpoint, you have the ability to create accounts which can optionally have another account as a parent.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6c6bec77-14d9-4199-988f-8cabcbb6df8f", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\",\n \"parent_id\": \"96b1f750-55d3-4768-a3f8-adffba694a2c\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_tags\": {\n \"data\": [\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n },\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n ]\n },\n \"ancestors\": [\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n },\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n }\n ],\n \"parent\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f68baa3-feed-4a18-b225-1f485d6d9bce", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0c83c30-9712-4621-b0e2-9faf7aeea734", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "032eab0e-ea36-4ff9-a635-183923b107aa", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8fd595f-4424-4d2a-af2a-134ee60bd498", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"store id mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "98f650a9-c4d6-4921-b082-381b8f6d11e2", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bd1fc068-0594-4be0-9c8b-1c42e7f5e30f", "name": "Get All Accounts", "request": { "name": "Get All Accounts", "description": { "content": "Use this endpoint to Get all accounts.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n### Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) accounts:\n\n| Attribute | Operators | Example |\n|-------------------|-------------------------------|---------------------------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,3fa85f64-5717-4562-b3fc-2c963f66afa6)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n| `name` | `eq`,`like` | `like(name,*swan*)` |\n| `legal_name` | `eq`,`like` | `like(legal_name,*swan*)` |\n| `registration_id` | `eq`,`like` | `like(registration_id,00000000-0000-1000-8000-*)` |\n| `external_ref` | `eq`,`like`,`in` | `like(external_ref,16be*)` |\n| `account_tags` | `contains` | `contains(account_tags,26beb787-be6e-40c3-bbae-9c645820b075)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which accounts will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "53050a6a-c6d1-465b-9e44-a1adf7327841", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which accounts will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\",\n \"parent_id\": \"96b1f750-55d3-4768-a3f8-adffba694a2c\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_tags\": {\n \"data\": [\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n },\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n ]\n },\n \"ancestors\": [\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n },\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n }\n ],\n \"parent\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n },\n {\n \"type\": \"string\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\",\n \"parent_id\": \"96b1f750-55d3-4768-a3f8-adffba694a2c\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_tags\": {\n \"data\": [\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n },\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n ]\n },\n \"ancestors\": [\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n },\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n }\n ],\n \"parent\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"https://VQcFiXryHHtKDFFCpCkJRAO.fkqwuv79S-pDOhgRCdJQqcMz.tIDbM+FEvXgle7Y0qa1Ya\",\n \"first\": \"https://xTdB.awmUG+PZk.Q3KfBLJp\",\n \"last\": \"https://pLWHTRfiqVyRmGKqihNZHQBLPAFQXrzEc.fsctUK-pmp9XPOw0oFZvI,QUbPomNGNPPC\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d61a277-0e68-45c6-bd41-89e2669a1def", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which accounts will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a6444db-3f8d-4c00-bd63-432e6645db51", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which accounts will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "827d4528-6577-454a-b7d6-3bbc9c4160b5", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which accounts will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "007e1642-c727-4824-a4d3-a59df8473ef0", "name": "Get an Account", "request": { "name": "Get an Account", "description": { "content": "View a specific account contained within your store", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2303e5d0-07a1-4c5e-b700-5106d16c44f0", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\",\n \"parent_id\": \"96b1f750-55d3-4768-a3f8-adffba694a2c\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_tags\": {\n \"data\": [\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n },\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n ]\n },\n \"ancestors\": [\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n },\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n }\n ],\n \"parent\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c40f837a-a98d-44d3-86f0-cc83ee6f65b4", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2f21992-082c-41ca-9c6b-295f6b429129", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e18f55f0-ef40-4382-bd5b-f8a682dd643c", "name": "Update an Account", "request": { "name": "Update an Account", "description": { "content": "Update the information contained on an account.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a7d7159f-ae1e-419e-8cf6-83926a1daed9", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\",\n \"parent_id\": \"96b1f750-55d3-4768-a3f8-adffba694a2c\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_tags\": {\n \"data\": [\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n },\n {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n ]\n },\n \"ancestors\": [\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n },\n {\n \"data\": {\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"type\": \"string\"\n }\n }\n ],\n \"parent\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n }\n },\n \"links\": {\n \"self\": \"http://GVTCbvUDUvEsxWOubgVQR.zpE+nQOzmKdvz2HdXyYnAMzGXnq1XxGbVWj\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3317dfe-4a23-4a9f-9a26-2630fd93ab4c", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n },\n {\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a921c47f-4e47-413d-aff5-e3dde1d5f3ac", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"account not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n },\n {\n \"detail\": \"account not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6d387e5-a94d-4414-8f66-c4cca817beb5", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab8c95e9-89ed-4fdf-bf60-d8d2321b1505", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account\",\n \"name\": \"acc-name\",\n \"legal_name\": \"acc-legal-name\",\n \"registration_id\": \"reg-id\",\n \"external_ref\": \"ext-ref\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1c8afa47-32c8-485c-81e0-883debe69b49", "name": "Delete an Account", "request": { "name": "Delete an Account", "description": { "content": "Delete a specific account within a store", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "22a8dab6-e5ce-4633-8229-0b39a681a82a", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b52b9d6f-b984-4bab-a476-6311557c6b57", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0b7b708-97f3-4295-a732-2330473f330a", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "de78939c-d018-49d0-ac88-7779d540d276", "name": "Get an Account's Tags Relationship", "request": { "name": "Get an Account's Tags Relationship", "description": { "content": "Get a list of Account Tags on an Account", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5fdfc67f-cc66-47fb-9b66-9c08cea7c5ba", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n ],\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/relationships/account-tags\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ff48519-d846-4ca3-81c1-7ef6e3d15c78", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab0acc05-c595-465e-948f-215a0f29b5a9", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3c291548-dabf-40ca-862d-7962404922e9", "name": "Add Account Tags", "request": { "name": "Add Account Tags", "description": { "content": "Add Account Tags onto an Account. Please note that after adding a tag to an account, the account member token should be regenerated to reflect the updated account status, allowing other services to react accordingly. See [Account Management Authentication Token](/docs/api/accounts/post-v-2-account-members-tokens).", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8a387a14-5db6-4222-988a-b3a8113fb488", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n ],\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/relationships/account-tags\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d500f204-bf78-49e5-8855-d0d3be0f67f2", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa417fe4-b145-47e2-a098-1646690d076f", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8f6b9ae-b577-447d-8863-608c60ec1017", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dddb2ef2-2b67-494f-af6c-5d05327fc7e1", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b5acf452-79c1-46e7-a4b4-7582d537422d", "name": "Remove Account Tags", "request": { "name": "Remove Account Tags", "description": { "content": "Remove Account Tags from an Account. Please note that after removing a tag from an account, the account member token should be regenerated to reflect the updated status, allowing other services to react accordingly. See [Account Management Authentication Token](/docs/api/accounts/post-v-2-account-members-tokens).", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b16e8c21-eb2b-4bbd-a1e0-d82eec2f423d", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n ],\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/relationships/account-tags\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bad2c0a-bb75-4cf9-b7fe-28379071459f", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8586109d-1d84-4295-8984-19a33d72ef10", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3164876b-cc47-4fd1-9e63-f26118ab41bd", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "relationships", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"account_tag\",\n \"id\": \"030693ce-39ad-4f4c-9941-d2d596478e94\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Members", "description": "An `Account Member` resource is a user that you can add to accounts using account memberships.\n\nAccount members API is read only, and you cannot add users using this API. There is a 1 to 1 correspondence between User Authentication Info and an Account Member, the corresponding objects have the same id. You must use the `user_authentication_info` object to create users in the authentication realm of account authentication settings. For more information on adding account members, see the [Adding Accounts and Account Members](/guides/How-To/Accounts/add-account-and-member) section.\n", "item": [ { "id": "af3d3991-8790-41fa-b3fd-d393e2d8a1ee", "name": "Get all Account Members", "request": { "name": "Get all Account Members", "description": { "content": "Get all account members contained within your store.\n\n ### Filtering\n\n\n The following operators and attributes are available for\n[filtering](/guides/Getting-Started/filtering) account members.\n\n| Attribute | Type | Operator | Example | | :--- | :--- | :--- | :--- | | `email` | `string` | `ilike` | `ilike(email,'ronswanson@example.com')` | | `name` | `string` | `ilike` | `ilike(name,'*swan*')` | | `given_name` | `string` | `ilike`/`is_null` | `ilike(given_name,'ron*')` | | `middle_name` | `string` | `ilike`/`is_null` | `is_null(middle_name)` | | `family_name` | `string` | `ilike`/`is_null` | `is_null(family_name)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,email,-email,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f74588fb-8329-4194-857f-64711a8a5347", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,email,-email,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n },\n {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"https://QmsNthQHzGAHlnFRPwHSHUQVDHS.jlknse9MoqxgjsAQnS8XnhTamlT\",\n \"first\": \"http://lScPfZhdLzr.indawyE5NzLs+iVR\",\n \"last\": \"http://gKEouYlpGQqrkM.mrtyguiGRZnYibcmg1dbLmEvx9ud2BVERa\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2906d789-8d7f-45be-871e-2d55d490c3f3", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,email,-email,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ac80873-4e68-4451-99a0-e973b20530d9", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,email,-email,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d92957a-5519-40b4-8c4e-0b0bfb85875b", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,email,-email,id,-id,name,-name,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1eee11a8-9f98-4f4a-b5f8-8b49e69f7e77", "name": "Get an Account Member", "request": { "name": "Get an Account Member", "description": { "content": "Get an account member from your store", "type": "text/plain" }, "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "716d51bd-d583-4045-a180-68c2b31bd8f4", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "113adbce-fe15-42e4-bdda-c6b3bda23e74", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "531fd56a-c328-4558-8093-1013372b9661", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1637d00f-e6aa-4fc9-ac03-356142c0d900", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e1c5a5c1-4535-4e45-9c1e-cad7c1fba621", "name": "Update an account member", "request": { "name": "Update an account member", "description": { "content": "This endpoint can be used to update an account member.", "type": "text/plain" }, "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to update the flows of.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_member\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e358b931-f596-4788-9127-d1d4b36dbfbf", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to update the flows of.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_member\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4739fcb1-4f83-4e7e-84d1-22a9328828c3", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to update the flows of.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_member\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4608540f-c1f5-4e35-a8cb-eed9638be45d", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to update the flows of.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_member\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2e3f135-52c8-4db0-8571-01bac7c59a53", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account member that you want to update the flows of.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_member\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Membership", "description": "The `Account Membership` resource represents the relationship between an account and an account member. This relationship is many to many. Each account can have multiple account members, and each account member can be a member of multiple accounts.", "item": [ { "id": "425276b6-7676-415e-bd60-f06fb406a428", "name": "Create an Account Membership", "request": { "name": "Create an Account Membership", "description": { "content": ":::caution\n\nYou can only create up to 1000 account memberships in an account.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "cd114c6c-70cc-4559-8dd9-00b2ed5dafdf", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_member\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/account-memberships/5ac48b3b-825d-43a3-9fcd-962230629d5e\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d65e009-eef0-4979-adf1-c17d37a2c53d", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a22bda06-b478-41fd-bca6-5a6478a21ad7", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33a33886-785a-43ef-b308-0587faf50e48", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a063b665-de96-43aa-9312-2f422a3c9927", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"store id mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4dbf0cb3-4c7f-47f9-921b-bdd9037a2cbf", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d6d104c-7b80-4203-9244-a259dda694e1", "name": "Get all Account Memberships", "request": { "name": "Get all Account Memberships", "description": { "content": "You can also use `include=account_member` to retrieve details about the account members associated with the account memberships. With this option, you can get more information about the account members such as name and email in a single request. For more information see [including resources](/guides/Getting-Started/includes).\n\n### Filtering\n\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) account memberships.\n\n| Operator | Description |\n| :--- | :--- |\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n| `like` | Checks if the operand contains the specified string. You can use wildcard characters in operand. |\n\n| Attribute | Type | Operator | Example |\n| :--- | :--- | :--- | :--- |\n| `account_member_id` | `string` | `eq` / `like` | `eq(account_member_id,00000000-0000-1000-8000-0000000)` |", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,-updated_at,id,-id)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a241f68b-9a73-4d7c-81d1-a5ced27a8bc8", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,-updated_at,id,-id)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_member\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n },\n \"account_member_id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n },\n {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_member\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n },\n \"account_member_id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"http://uqaDNawTSdekBzRyoFbZZccPeVeQMnKqs.zehuCCl8gEmOIZfvS9U\",\n \"first\": \"https://HmTHRIMf.toVVYmmMx9Lu6mxpF3.dNoZ5\",\n \"last\": \"http://puXmuGhiviriQDlTiyMzeEumHKNJB.ujuy09BJbIEQP672-4TseM7yJmBIubdm,tH0iHzTijDTqM1MZ+QXeaELnK7\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "328c13a3-b1d0-4177-84a9-8930a9351511", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,-updated_at,id,-id)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a0c6db4-7119-490f-ab5d-4b415fb8533b", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,-updated_at,id,-id)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "433476be-308a-4a1b-84f4-4f56e0278345", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,-updated_at,id,-id)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d96da4f9-c22c-46c5-8ed9-b49d3b2d04b4", "name": "Get a List of Account Memberships of Account Member", "request": { "name": "Get a List of Account Memberships of Account Member", "description": { "content": "You can also use `include=account` to retrieve details about the accounts associated with the account memberships. For more information see [including resources](/guides/Getting-Started/includes).\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n### Filtering\n\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) account memberships.\n\n| Operator | Description |\n| :--- | :--- |\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n| `like` | Checks if the operand contains the specified string. You can use wildcard characters in operand. |\n\n| Attribute | Type | Operator | Example |\n| :--- | :--- | :--- | :--- |\n| `account_member_id` | `string` | `eq` / `like` | `eq(account_member_id,00000000-0000-1000-8000-0000000)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "account-members", ":accountMemberId", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like accounts.", "type": "text/plain" }, "key": "include", "value": "account" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "-updated_at" } ], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberId", "disabled": false, "description": { "content": "(Required) The ID of the account member for which you want to list the memberships.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "dd957ac4-ccdf-4431-bd1c-c2b8300df492", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberId", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like accounts.", "type": "text/plain" }, "key": "include", "value": "account" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "-updated_at" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account member for which you want to list the memberships.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n },\n \"account_member_id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n },\n {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n },\n \"account_member_id\": \"deb6b25f-8451-4211-9a22-95610333df23\"\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"http://nSpPlPR.yjuxV0zg24QpAgiIVah\",\n \"first\": \"https://p.crbgxTqDpsx0XxfHewB0uoHG73wr\",\n \"last\": \"https://cuNuYxmrFDQYBpVRuW.hnu6wvPj3+YPlodEh\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d75bdef4-fb15-416f-b19d-e18b539ba042", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberId", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like accounts.", "type": "text/plain" }, "key": "include", "value": "account" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "-updated_at" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account member for which you want to list the memberships.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d86c2ec2-fe08-4229-98c4-28e96386bf35", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberId", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like accounts.", "type": "text/plain" }, "key": "include", "value": "account" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "-updated_at" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account member for which you want to list the memberships.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "922f144a-4d5e-41e1-bdef-25a2b7e04a01", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-members", ":accountMemberId", "account-memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like accounts.", "type": "text/plain" }, "key": "include", "value": "account" }, { "disabled": false, "description": { "content": "Specifies the order in which account memberships will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "-updated_at" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account member for which you want to list the memberships.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountMemberId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1e144fe9-5d07-4cb6-84ff-5131e905542f", "name": "Get a List of Unassigned Account Members", "request": { "name": "Get a List of Unassigned Account Members", "description": { "content": "Use this resource to get a list of all account members that are not assigned to an account.\n\n### Filtering\n\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) unassigned account members.\n\n| Operator | Description |\n| :------- | :--------------------------------------------------------------------------------------------------- |\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n| `like` | Checks if the operand contains the specified string. You can use wildcard characters in operand. |\n\n| Attribute | Type | Operator | Example |\n| :-------- | :------- | :------------ | :--------------------------------- |\n| `email` | `string` | `eq` / `like` | `eq(email,ronswanson@example.com)` |\n| `name` | `string` | `eq` / `like` | `like(name,*swan*)` |\n\n:::note\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n:::", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "04b199d6-51d9-4bb9-861d-837861b47b5a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n },\n {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"given_name\": \"Ron\",\n \"middle_name\": \"Ulysses\",\n \"family_name\": \"Swanson\",\n \"email\": \"ron@swanson.com\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-members/908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"https://NxlzNjKtFplUHPCBcGi.zbcuA5.O0bPu8VX3IrK9auMPWjshzE\",\n \"first\": \"http://juXWVqKHQZFGmtYnacLQSXpnhkLHHS.ybxN0\",\n \"last\": \"http://gmaeapRdTccfARFwPgiKpqwPCWDPJeMw.yezpfEmDcMfANOijpuauLv8bvdmrFlU8h1g4NhZSuDU2BvDjHFxMxLexfOGFuO\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df845a0c-5763-4c55-bd71-96a74a4f0dd0", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0fe40e3-030d-4092-82ca-c20f72fe54ae", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0ee128e-89e7-4f9d-b0b7-01d730525cca", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5148dbce-1a99-472b-9782-3b0fca0efbb3", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", "unassigned-account-members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "Specifies the order in which unassigned account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,updated_at,updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account for which you want to get the list of unassigned account members.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a8cb0f50-e876-4071-bce6-ee4e5a956830", "name": "Get an Account Membership", "request": { "name": "Get an Account Membership", "description": { "content": "Get an account membership from an account in your store.\n\nYou can also use `include=account_member` to retrieve details about the account member associated with this account membership. With this option, you can get more information about the account member such as name and email in a single request. For more information see [including resources](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" } ], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" } }, { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6feba9d0-abe8-41ac-8608-91273c904ca7", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_member\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/account-memberships/5ac48b3b-825d-43a3-9fcd-962230629d5e\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "603a6399-6c6b-4e19-8856-89a0bb659bb0", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a86202cc-cd01-43fe-b1b9-cfbb61d805bf", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Parameter to retrieve more information about any related resources like account members.", "type": "text/plain" }, "key": "include", "value": "account_member" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8be2dbb6-8a62-4303-9646-e4e437a899d3", "name": "Update an Account Membership", "request": { "name": "Update an Account Membership", "description": { "content": "You can update and extend an account member details using [core flows](/docs/api/flows/flows#extend-an-existing-resource). However, you cannot update the `account_member_id` of an account member.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" } }, { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "75f59243-700a-414f-b2de-2c9110b02c68", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"24e939f6-178f-497b-9d64-5bf2b5a70a2e\",\n \"type\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"relationships\": {\n \"account_member\": {\n \"data\": {\n \"id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"type\": \"string\"\n }\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/5b495058-9ffc-4b9b-810a-c9d43ffc6500/account-memberships/24e939f6-178f-497b-9d64-5bf2b5a70a2e\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/account-memberships/5ac48b3b-825d-43a3-9fcd-962230629d5e\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "165ba90b-c514-4d32-bb86-bffb5ca44589", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "758db9ec-19fe-41fe-8b50-978dceb92de9", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1286a6a7-ca34-467a-afed-6ffeee3dfb48", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b017b865-3052-493c-819e-24d20e8daa5e", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership\",\n \"account_member_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ceb29f3f-751e-4e5c-ad0d-a0e37fa106e7", "name": "Delete an Account Membership", "request": { "name": "Delete an Account Membership", "description": { "content": "Delete a membership from an account", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" } }, { "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID", "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "d7849339-378a-4e09-9add-c70907826e7a", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d936a913-2c0b-4e27-8a3b-ff7eba024b55", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21a695af-a8a0-4fe4-bb14-7b7eaaa86f91", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "account-memberships", ":membershipID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the account that the account member is associated with.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the account membership to update the details of the account member.", "type": "text/plain" }, "type": "any", "value": "cf18a5f0-cbad-aab6-6d1b-5dfd02d739c8", "key": "membershipID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Membership Settings", "description": "Account Membership Settings allow Account Members to be associated to, at most, N accounts at a time. You can set this value to any number up to 10,000. The default value is 10,000.\n\nThis setting is only applied to new account memberships. If an account member is added to 3 accounts, and the setting is reduced to 1, the account member remains in the 3 accounts and can no longer be added to more.\n", "item": [ { "id": "933c6530-ae2c-46ca-81d4-fec14c69aa60", "name": "Get Account Membership Settings", "request": { "name": "Get Account Membership Settings", "description": { "content": "Use this endpoint to get all account membership settings.", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "166558ec-c093-4770-bc41-b7ac47e34664", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 100\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f58d4b0a-06e4-4889-812d-5d57823c6898", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdd37ed0-c610-439e-8ab1-9ca538c34ee2", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8cb78d9f-2247-410b-a182-af3b7d77b711", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f3cee47d-630d-4ddf-825f-7a6906af8a5b", "name": "Update Account Membership Settings", "request": { "name": "Update Account Membership Settings", "description": { "content": "Use this endpoint to update account membership settings.", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 1000\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ed0f1e6f-c405-4d12-b708-1784574336e5", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 1000\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 100\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb1b3c25-5159-4190-bb88-71c376b8b03e", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 1000\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eaac20cd-b7d1-492d-b5c2-7ed359aeeee4", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "account-membership" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_membership_setting\",\n \"membership_limit\": 1000\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Management Authentication", "description": "Commerce provides authentication tokens for an `Account` and an `Account Member`.", "item": [ { "id": "4ad7e981-d31f-44d8-8648-662b90f1c6c7", "name": "Generate an Account Management Authentication Token", "request": { "name": "Generate an Account Management Authentication Token", "description": { "content": "Commerce provides authentication tokens for anyone using the Account Management APIs, including accounts and account members.\n\nFor each element in the list returned by the account member authentication API, a token value is returned. In order for a shopper to authenticate as the account, this value should be set as the `EP-Account-Management-Authentication-Token` header when calling Commerce. This header grants access to additional resources associated with the account, such as [carts](/docs/api/carts/account-cart-associations), [orders](/docs/api/carts/orders), [catalogs with associated rules](/docs/api/pxm/catalog/rules), and [addresses](/docs/api/addresses/addresses-introduction).\n\nThe set of permissions available to a shopper using an Account Management Authentication token is documented in [Permissions](/docs/authentication/tokens/permissions)\n\nCommerce provides authentication tokens for an account and an account member using:\n\n- OpenID Connect\n- Username and password\n- Self signup\n- One-time password token\n- Switch account token\n", "type": "text/plain" }, "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "12d6e74b-0f6e-439b-8a10-4a0b235f5448", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"account_name\": \"acc-name-1\",\n \"account_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOiIyMDIxLTAzLTE2VDE5OjM2OjExLjA3MFoiLCJpYXQiOiIyMDIxLTAzLTE1VDE5OjM2OjExLjA3MFoiLCJzY29wZSI6IjFjNDVlNGVjLTI2ZTAtNDA0My04NmU0LWMxNWI5Y2Y5ODVhMyIsInN1YiI6IjFjNDVlNGVjLTI2ZTAtNDA0My04NmU0LWMxNWI5Y2Y5ODVhMiJ9.ytQ3UutTl_RJ8NiB1xN29Ta23p-FXsYOhcUM7MUQ4CM\",\n \"expires\": \"2021-03-16T19:36:11.070Z\"\n },\n {\n \"type\": \"string\",\n \"account_name\": \"acc-name-1\",\n \"account_id\": \"908f7849-60da-4e4a-a3b1-51d4cbe3b953\",\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOiIyMDIxLTAzLTE2VDE5OjM2OjExLjA3MFoiLCJpYXQiOiIyMDIxLTAzLTE1VDE5OjM2OjExLjA3MFoiLCJzY29wZSI6IjFjNDVlNGVjLTI2ZTAtNDA0My04NmU0LWMxNWI5Y2Y5ODVhMyIsInN1YiI6IjFjNDVlNGVjLTI2ZTAtNDA0My04NmU0LWMxNWI5Y2Y5ODVhMiJ9.ytQ3UutTl_RJ8NiB1xN29Ta23p-FXsYOhcUM7MUQ4CM\",\n \"expires\": \"2021-03-16T19:36:11.070Z\"\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n },\n \"account_member_id\": \"f5d08d48-bbc8-4f61-818f-a78583045f56\"\n },\n \"links\": {\n \"current\": \"http://gMXpobkDLTbjnNVolCIJUDAPHW.zdWvgr2\",\n \"first\": \"https://PpuYejnfTrUOqNwxvijER.opyRQfMudqY0rvvlzRLBhzljhYQ3uFE8UCW7hY78Sy.o\",\n \"last\": \"http://IFUqJBNFziUmxUyEKoJCp.omwpdU0jrU2XucqDWq0RGyx\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01774c05-19ff-4d25-a088-958dc4fb55bb", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8daed564-0c6c-42f1-880e-be1d7b435693", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e476d21-f766-407b-b9d5-b612dfae5ef3", "name": "Forbidden Error", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"forbidden\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2566f783-c9bf-4b73-b1bb-65d5da92214e", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f2b57da-7c40-4058-ae7b-1d88fa38a17f", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"store id mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d1540b1-1f0b-4d9c-a995-d1f79aa19d6d", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-members", "tokens" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_management_authentication_token\",\n \"authentication_mechanism\": \"oidc\",\n \"oauth_authorization_code\": \"c2490f06-6d8e-4927-99aa-4bf02b419e96\",\n \"oauth_redirect_uri\": \"https://example-store.com/oauth2/callback\",\n \"oauth_code_verifier\": \"0E934PurR8ExVg6Pj7T4kQewxKzWSfSFG5d15FGfww8\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Authentication Settings", "description": "You can use the Account Authentication Settings endpoint to retrieve or modify how settings controlling account and account member authentication.", "item": [ { "id": "0a3d978a-2cac-43b5-ad9a-7b6cbf2f2a8b", "name": "Get Account Authentication Settings", "request": { "name": "Get Account Authentication Settings", "description": { "content": "Use this endpoint to view account authentication settings", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ae075263-9cc3-4bb5-9c7b-2ea9e3be052f", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400,\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"relationships\": {\n \"authentication_realm\": {\n \"data\": {\n \"id\": \"3418c54e-d768-42c1-a9db-d7afd2a18452\",\n \"type\": \"string\",\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/3418c54e-d768-42c1-a9db-d7afd2a18452\"\n }\n }\n }\n },\n \"meta\": {\n \"client_id\": \"account-management\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account_authentication_settings\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05bfa444-1a52-49aa-8880-77a634944725", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be9a22fe-e5f0-48ca-966a-92f6f8a2f77b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f04279a9-c33b-4d5a-bc4a-9d35f0488631", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e94b15c-69c2-4059-80d0-c09d536459ff", "name": "Update Account Authentication Settings", "request": { "name": "Update Account Authentication Settings", "description": { "content": "Use this endpoint to update account authentication settings", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c21fcb35-a200-4679-b998-3a37fef7b6d0", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400,\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"relationships\": {\n \"authentication_realm\": {\n \"data\": {\n \"id\": \"3418c54e-d768-42c1-a9db-d7afd2a18452\",\n \"type\": \"string\",\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/3418c54e-d768-42c1-a9db-d7afd2a18452\"\n }\n }\n }\n },\n \"meta\": {\n \"client_id\": \"account-management\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account_authentication_settings\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "719963e5-9be6-4537-9abe-40ee1acc6a77", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a400b7f-e8eb-4c3d-91b0-4a1edcb23199", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"store id mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c88413e-d242-4058-b224-fe3a895b49fd", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "account-authentication" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"enable_self_signup\": true,\n \"auto_create_account_for_account_members\": true,\n \"account_member_self_management\": \"disabled\",\n \"account_management_authentication_token_timeout_secs\": 86400\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Tags", "description": "Account Tags are custom labels or metadata that can be attached to accounts to help organize and filter them based on specific attributes or criteria.\n", "item": [ { "id": "df1d252f-3a06-4ab1-a39b-aa1c78f708a9", "name": "Create an Account Tag", "request": { "name": "Create an Account Tag", "description": { "content": "Create an Account Tag", "type": "text/plain" }, "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "39936114-eee4-43e9-9818-04dc31aa538f", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"account-name-tag\",\n \"description\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-tags/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b29a9e2d-3435-405f-88bc-29c7fda34d4b", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fbc5f82-e8b7-43e1-808b-b447f4c3bbb7", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e3ef245-86ab-4337-9932-37293b723cc2", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa99da4e-cca1-4c63-ad36-e925d484d638", "name": "List Account Tags", "request": { "name": "List Account Tags", "description": { "content": "Retrieves a list of Account Tags\n\n## Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) Account Tags:\n\n| Attribute | Operators | Example |\n|------------------|-------------------------------|-----------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,3fa85f64-5717-4562-b3fc-2c963f66afa6)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n| `name` | `eq`,`like` | `eq(name,AccountName)` |\n\n## Sorting\nThe following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with `-`, for example, `-updated_at`. The default sort order is `created_at` in descending order.\n- `id`\n- `created_at`\n- `updated_at`\n- `name`\n", "type": "text/plain" }, "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which account tags will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c33fd6d8-ff1c-43c5-8b09-a64ec6f7386f", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which account tags will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"name\": \"account-name-tag\",\n \"description\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-tags/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n },\n {\n \"type\": \"string\",\n \"name\": \"account-name-tag\",\n \"description\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-tags/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"current\": 0,\n \"offset\": 0,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"http://DCEeVSvBBamBLxmeplGnlA.alsczdZUlNJIctCXLds73oum-UM+ZkatuqkeLhW9G\",\n \"first\": \"https://AAubFdIIusSXvLgWdHikPTZIxDPupzL.abwtO6-en\",\n \"last\": \"http://P.dpce4SoJq5AQTEz\",\n \"next\": \"string\",\n \"prev\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6af342b2-2b06-4113-87eb-efa32a3b278c", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which account tags will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f116f340-61d7-4f43-8350-be83fd413ade", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-tags" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "ilike(name,\"*swan*\")" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "Specifies the order in which account tags will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ca06bab1-8b4f-4b11-874d-e8b7203f3c3d", "name": "Get an Account Tag", "request": { "name": "Get an Account Tag", "description": { "content": "Get an Account Tag", "type": "text/plain" }, "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id", "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ce0bcde7-10b1-44aa-9c53-f5c700835cdc", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"account-name-tag\",\n \"description\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-tags/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "673dfcaf-6f37-4c81-8ade-ca04987ab6b9", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9ca0b67-9085-435f-83fc-3e6c95989788", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4fa88323-0adf-4cf6-a5d9-906ab660d73e", "name": "Update an Account Tag", "request": { "name": "Update an Account Tag", "description": { "content": "Update an Account Tag", "type": "text/plain" }, "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id", "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "4809fc82-4bae-49fb-ab79-9aa4869794cb", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"account-name-tag\",\n \"description\": \"string\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/account-tags/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2585115d-fd23-49e2-a4a7-72a14ace2d63", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c01ae33-dc5e-4878-b616-bc5635f04537", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fdd7e98-8ed6-4458-afa7-ac88732f8627", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"account membership with the given account id and account member id already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90f7f33b-c269-49f4-abde-52d4d3288658", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"account_tag\",\n \"name\": \"Account Name\",\n \"description\": \"Account Description\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9a35767e-761d-4a2a-85fd-dbb34b54e964", "name": "Delete an Account Tag", "request": { "name": "Delete an Account Tag", "description": { "content": "Delete an Account Tag", "type": "text/plain" }, "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id", "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "29575f81-0ce3-43f8-a3d8-5b6258ec1e8c", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ee6bf461-95c8-4233-9856-10eec52e1e29", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbf39a1a-787d-4866-8703-ebc117f4c967", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "account-tags", ":tag_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Account Tag.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "tag_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Addresses", "description": "The API to organize account addresses.", "item": [ { "id": "7f54aedf-4a1b-4994-98cb-c453838bae1f", "name": "Create an Account Address", "request": { "name": "Create an Account Address", "description": { "content": "Create an address for an Account.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "565f406b-d85a-4947-981d-a6acf9484b63", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6ba2a67-ce3e-49bd-8ae5-d1575b9b73c7", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "814e938e-2bdc-48ad-aed9-324ccf3592c4", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47170063-a615-4e64-96f2-51923c1d01aa", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7fed5bf3-022a-4901-9b4d-949e89efdf53", "name": "Get Account Addresses", "request": { "name": "Get Account Addresses", "description": { "content": "Get all addresses for an Account.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n### Filtering\n\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) addresses:\n\n| Attribute | Operators | Example |\n|----------------|---------------------------------|---------------------------------------|\n| `name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(name,\"*home*\")` |\n| `first_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(first_name,\"Ron*\")` |\n| `last_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(last_name,\"*swan*\")` |\n| `phone_number` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(phone_number,\"*555*\")` |\n| `company_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(company_name,\"*enterprises*\")` |\n| `instructions` | `eq`,`in`,`like`,`ilike`,`text` | `text(instructions,\"behind bin\")` |\n| `line_1` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(line_1,\"*Sunny Street*\")` |\n| `line_2` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(line_2,\"*Unit*\")` |\n| `city` | `eq`,`in`,`like`,`ilike`,`text` | `eq(city,\"Sunny Town\")` |\n| `county` | `eq`,`in`,`like`,`ilike`,`text` | `eq(county,\"Sunnyville\")` |\n| `region` | `eq`,`in`,`like`,`ilike`,`text` | `eq(region,\"California\")` |\n| `postcode` | `eq`,`in`,`like`,`ilike`,`text` | `eq(postcode,\"SU33 1YY\")` |\n| `country` | `eq`,`in`,`like`,`ilike`,`text` | `eq(country,\"GB\")` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6c0844e4-b2a6-4182-9e8e-fa04a84583ba", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n },\n {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 3\n },\n \"results\": {\n \"total\": 75,\n \"total_method\": \"exact\"\n }\n },\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=0&page[limit]=25\",\n \"first\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=0&page[limit]=25\",\n \"last\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=50&page[limit]=25\",\n \"next\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=25&page[limit]=25\",\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7600c351-9312-48a0-8f4e-b17034fe50e9", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea8a4557-48fe-49d4-81b9-e62035a30219", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "85c9fa93-8fd1-46cf-8ac6-66b84bf95c20", "name": "Get an Account Address", "request": { "name": "Get an Account Address", "description": { "content": "Get a specific address for an Account.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3ee3414c-1bc0-4831-a72f-1b0982973c4f", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67db2d9c-482f-4fe2-a90b-e24a7d267b09", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "61101530-7a53-4c3e-972f-2956b97ac912", "name": "Update an Account Address", "request": { "name": "Update an Account Address", "description": { "content": "Update an address for an Account.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the address you want to update.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d81ab369-6eba-47d4-91f6-e83514fc8d8e", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"account\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"account\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fefa4b11-99b3-4911-94c0-f8a6793e5b93", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8744f31-4be9-470c-ae4e-8321e03221fd", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4fc2f988-6316-415e-8c24-3372ce28531d", "name": "Delete an Account Address", "request": { "name": "Delete an Account Address", "description": { "content": "Delete an address for an Account.", "type": "text/plain" }, "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "accountID", "disabled": false, "description": { "content": "(Required) The ID of the account that contains the address to delete.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2ba02168-2bea-495a-a606-61b93cf5ce90", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account that contains the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d2751148-d6f1-4871-80d7-245b9be8ab51", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "accounts", ":accountID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the account that contains the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "accountID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"account not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Generate an Access Token", "description": "", "item": [ { "id": "1c7820c9-28c9-49dd-b7fb-629934418329", "name": "Create an Access Token", "request": { "name": "Create an Access Token", "description": { "content": "\n### Client Credentials\n\nA `client_credentials` token is used when the credentials are not publicly exposed, usually a server-side language such as PHP or Node.js. This type of authentication enables `CRUD` access to all resources.\n\n`client_id` and `client_secret` are created and managed via [Application Keys](/docs/api/application-keys/create-an-application-key).\n\nTo see the access granted by a `client_credentials` token, refer to [Permissions](/docs/authentication/tokens/permissions).\n\n\n### Implicit\n\nAn `implicit` token is typically used for situations where you are requesting data on the client side and you are exposing your public key. When authenticated implicitly, you can only fetch (`GET`) data with live status (products, categories, brands, etc).\n\nThe `implicit` token is most appropriate for use inside client-side applications, such as JavaScript.\n\n:::caution\nAn `implicit` token can be thought of as a **Read only** token.\n:::\n", "type": "text/plain" }, "url": { "path": [ "oauth", "access_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) The grant type.", "type": "text/plain" }, "key": "grant_type", "value": "implicit" }, { "disabled": false, "description": { "content": "(Required) Your `client_id`", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "Your `client_secret`. Only required for client credentials.", "type": "text/plain" }, "key": "client_secret", "value": "string" } ] }, "auth": null }, "response": [ { "id": "54c4fb59-64e7-4b71-a86a-14ac63df06e5", "name": "Access Token", "originalRequest": { "url": { "path": [ "oauth", "access_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) The grant type.", "type": "text/plain" }, "key": "grant_type", "value": "implicit" }, { "disabled": false, "description": { "content": "(Required) Your `client_id`", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "Your `client_secret`. Only required for client credentials.", "type": "text/plain" }, "key": "client_secret", "value": "string" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"xa3521ca621113e44eeed9232fa3e54571cb08bc\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600,\n \"expires\": 1524486008,\n \"identifier\": \"client_credentials\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e238a9a6-d873-476a-96d4-9193bb8e4da0", "name": "Bad Request", "originalRequest": { "url": { "path": [ "oauth", "access_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) The grant type.", "type": "text/plain" }, "key": "grant_type", "value": "implicit" }, { "disabled": false, "description": { "content": "(Required) Your `client_id`", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "Your `client_secret`. Only required for client credentials.", "type": "text/plain" }, "key": "client_secret", "value": "string" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cec49311-ba17-41ae-b752-e8f28d6d0ec0", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "oauth", "access_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) The grant type.", "type": "text/plain" }, "key": "grant_type", "value": "implicit" }, { "disabled": false, "description": { "content": "(Required) Your `client_id`", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "Your `client_secret`. Only required for client credentials.", "type": "text/plain" }, "key": "client_secret", "value": "string" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\",\n \"detail\": \"Unauthorized\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aea96376-79f2-42cd-96cd-57b782c9008b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "oauth", "access_token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/x-www-form-urlencoded" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "urlencoded", "urlencoded": [ { "disabled": false, "description": { "content": "(Required) The grant type.", "type": "text/plain" }, "key": "grant_type", "value": "implicit" }, { "disabled": false, "description": { "content": "(Required) Your `client_id`", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "Your `client_secret`. Only required for client credentials.", "type": "text/plain" }, "key": "client_secret", "value": "string" } ] } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Customer Addresses", "description": "The API to organize customer addresses.", "item": [ { "id": "dce79001-0dc4-445f-a5fc-4707c0fc7b23", "name": "Create a Customer Address", "request": { "name": "Create a Customer Address", "description": { "content": "Create an address for a Customer.", "type": "text/plain" }, "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "customerID", "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ef9f65bc-706b-406b-a592-d2111931fe5c", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77e92af1-a665-49eb-be61-1f26912cf5ee", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d87e977-b5c0-4cb1-88b7-d05ccca18e58", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8fb3756d-2ff9-4c6e-a865-474f56d3c380", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"customer not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0dba6fa5-3d4c-41cc-8732-fe5d4800f052", "name": "Get Customer Addresses", "request": { "name": "Get Customer Addresses", "description": { "content": "Get all addresses for a Customer.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n### Filtering\n\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) addresses:\n\n| Attribute | Operators | Example |\n|----------------|---------------------------------|---------------------------------------|\n| `name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(name,\"*home*\")` |\n| `first_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(first_name,\"Ron*\")` |\n| `last_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(last_name,\"*swan*\")` |\n| `phone_number` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(phone_number,\"*555*\")` |\n| `company_name` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(company_name,\"*enterprises*\")` |\n| `instructions` | `eq`,`in`,`like`,`ilike`,`text` | `text(instructions,\"behind bin\")` |\n| `line_1` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(line_1,\"*Sunny Street*\")` |\n| `line_2` | `eq`,`in`,`like`,`ilike`,`text` | `ilike(line_2,\"*Unit*\")` |\n| `city` | `eq`,`in`,`like`,`ilike`,`text` | `eq(city,\"Sunny Town\")` |\n| `county` | `eq`,`in`,`like`,`ilike`,`text` | `eq(county,\"Sunnyville\")` |\n| `region` | `eq`,`in`,`like`,`ilike`,`text` | `eq(region,\"California\")` |\n| `postcode` | `eq`,`in`,`like`,`ilike`,`text` | `eq(postcode,\"SU33 1YY\")` |\n| `country` | `eq`,`in`,`like`,`ilike`,`text` | `eq(country,\"GB\")` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "customerID", "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0c063177-1f16-4b35-bec9-05ab7099c70a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n },\n {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 3\n },\n \"results\": {\n \"total\": 75,\n \"total_method\": \"exact\"\n }\n },\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=0&page[limit]=25\",\n \"first\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=0&page[limit]=25\",\n \"last\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=50&page[limit]=25\",\n \"next\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses?page[offset]=25&page[limit]=25\",\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "536930f1-a29a-46fe-af79-aa1a963e3da4", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "feded99b-7d94-46e2-8de8-f78370165cc7", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. If not specified, defaults to the `page_length` setting from the Settings API.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The method used to calculate the total count. `lower_bound` limits expensive count operations, `observed` uses a lightweight +1 fetch strategy that will indicate if there is a next page. (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter addresses using a simple query language.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"customer not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a7cfa2c1-b60c-4c6a-8980-82b150a76549", "name": "Get an Customer Address", "request": { "name": "Get an Customer Address", "description": { "content": "Get an address for a Customer.", "type": "text/plain" }, "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "customerID", "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d47096eb-59ca-48db-ba7c-fd55fc7e0e2a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cffc64eb-0195-4433-8679-5201ac31a431", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"customer not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5464d38d-7da5-4718-87a3-826b229aff5d", "name": "Update an Customer Address", "request": { "name": "Update an Customer Address", "description": { "content": "Update an address for a Customer.", "type": "text/plain" }, "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "customerID", "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the customer you want to update.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "656eddce-b084-4093-ae16-4e28a9eef295", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\",\n \"id\": \"5f8da740-6680-463e-b31c-190b2db4bf9d\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/customers/deb6b25f-8451-4211-9a22-95610333df23/addresses\"\n },\n \"relationships\": {\n \"customer\": {\n \"id\": \"11afcf9b-971b-4fdb-8e10-f2ecf970718e\",\n \"type\": \"customer\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "314be617-a712-48b1-8e70-334ab2bead1f", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efc86c44-e12d-4fdb-b5b3-3f142e7aab4e", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to create an address for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the customer you want to update.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"address\",\n \"first_name\": \"Ron\",\n \"last_name\": \"Swanson\",\n \"name\": \"Home\",\n \"phone_number\": \"(555) 555-1234\",\n \"instructions\": \"Leave behind bin\",\n \"company_name\": \"Ron Swanson Enterprises\",\n \"line_1\": \"1 Sunny Street\",\n \"line_2\": \"Unit 101\",\n \"city\": \"Sunny Town\",\n \"county\": \"Sunnyville\",\n \"region\": \"acc-legal-name\",\n \"postcode\": \"SU33 1YY\",\n \"country\": \"GB\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"customer not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a4a21a5c-58d1-4513-ad93-eb01042ddc06", "name": "Delete a Customer Address", "request": { "name": "Delete a Customer Address", "description": { "content": "Delete an address for a Customer.", "type": "text/plain" }, "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "customerID", "disabled": false, "description": { "content": "(Required) The ID of the customer that contains the address to delete.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "addressID", "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "58c44ef5-6788-44ff-8791-8445bce0f937", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer that contains the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "68c7c15c-a01d-4fa0-8f70-7a2bde24b664", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "customers", ":customerID", "addresses", ":addressID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the customer that contains the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customerID" }, { "disabled": false, "description": { "content": "(Required) The ID of the address to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "addressID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"customer not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Application Keys", "description": "You can use application keys to generate `client_credentials` and `implicit` tokens.", "item": [ { "id": "abb70361-3d5f-42db-be7f-f62dd7dbf134", "name": "Create an Application Key", "request": { "name": "Create an Application Key", "description": { "content": "Create an Application Key", "type": "text/plain" }, "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Storefront-Key\",\n \"reserved_rate_limit\": 0\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "85d1ec33-0558-4441-880e-1e772cfa02e0", "name": "An Application Key", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Storefront-Key\",\n \"reserved_rate_limit\": 0\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"5e0cb85d-05bd-382c-d765-15e77588b839\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"reserved_rate_limit\": 1369,\n \"client_id\": \"Z2dDp1f1Tg30p2C6ZVit7W1AKUtVhMVSTAPOIK4adA\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\",\n \"last_used_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"client_secret\": \"jN8qLHneOn8C1rv0r3J3XZK1cRiZG3rajcLi9X1cZZ\"\n },\n \"links\": {\n \"self\": \"http://hVuCgrBQMj.paxxHWlHyvgh9WgAfzxsUVxemrZCmO8Fmud4H3mkYLz+Uyr2183fjIc\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a1e98f1-1916-4218-b510-daea6c32f722", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Storefront-Key\",\n \"reserved_rate_limit\": 0\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bba0fb61-50e5-4c94-a21f-6e0702111524", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Storefront-Key\",\n \"reserved_rate_limit\": 0\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"Requested reserved rate limit will exceed the maximum.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff85ec60-0c23-41b4-b727-f49d4c92d6cf", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Storefront-Key\",\n \"reserved_rate_limit\": 0\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2b46b96e-268a-4027-b3fb-9fbec73cb30a", "name": "List Application Keys", "request": { "name": "List Application Keys", "description": { "content": "Retrieves a list of Application Keys\n", "type": "text/plain" }, "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c25b16f5-3261-490e-812f-6564cc81a9c9", "name": "List of Application Keys", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ae0191a7-3df6-819b-4bb9-67cbe4c14aab\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"reserved_rate_limit\": 9772,\n \"client_id\": \"Z2dDp1f1Tg30p2C6ZVit7W1AKUtVhMVSTAPOIK4adA\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\",\n \"last_used_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n },\n {\n \"id\": \"c5104513-39a8-f294-8110-918b7f9ed496\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"reserved_rate_limit\": 1886,\n \"client_id\": \"Z2dDp1f1Tg30p2C6ZVit7W1AKUtVhMVSTAPOIK4adA\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\",\n \"last_used_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 5208\n },\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"total_reserved_rate_limit\": 100\n },\n \"links\": {\n \"current\": \"https://tXiTTzkdZcDdbbuUTpyHpokKkOuGsS.mnLbCkcm9iVS9Gd+oXIW9WKockGwTL+WPBNEsjjkpYp766yD6dchlp-75OHVM\",\n \"first\": null,\n \"last\": null,\n \"next\": \"http://dYwbEhsqL.eeHye+shFFcbIyoYVgb52Anr-mCJlqHK0Xm9Uham7H,iK.8KkANvM9p78EpRMdB\",\n \"prev\": \"https://mZKoi.fetwAv,qVMNVNu9QChIHhb.fouCn2P1b,QTVQiRyZqUHwEOJIFW0sVs1JaYimX+oz\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91dc5125-03c1-486c-a040-cbdc9e95d8ec", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa901a28-4042-431a-8ebe-af3baa975c1b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "application-keys" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "400a1386-8d62-4a9a-b210-a7d6464ac8d0", "name": "Get an Application Key", "request": { "name": "Get an Application Key", "description": { "content": "Get an Application Key", "type": "text/plain" }, "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "37cf1c0d-f294-49c1-aaed-e214ec02d5b6", "name": "An Application Key", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d08f453d-ab5e-2a81-356d-b9932530957a\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"reserved_rate_limit\": 8756,\n \"client_id\": \"Z2dDp1f1Tg30p2C6ZVit7W1AKUtVhMVSTAPOIK4adA\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\",\n \"last_used_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://OwW.aktsa4CQsKGBuiXI17wid.6grLEE8G3\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee083db3-5333-4ab7-b175-9f36b91454c4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adaf036f-d972-4e49-9dee-7fcf8b463b73", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8047dbc-2847-4637-8136-17401a2838d3", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6935fa91-7c09-4373-894e-54f114ce4bb3", "name": "Update an Application Key", "request": { "name": "Update an Application Key", "description": { "content": "Update an Application Key", "type": "text/plain" }, "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "103c4c8c-f961-489e-9a15-2aab2f217ac2", "name": "An Application Key", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d08f453d-ab5e-2a81-356d-b9932530957a\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"reserved_rate_limit\": 8756,\n \"client_id\": \"Z2dDp1f1Tg30p2C6ZVit7W1AKUtVhMVSTAPOIK4adA\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\",\n \"last_used_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n },\n \"links\": {\n \"self\": \"http://OwW.aktsa4CQsKGBuiXI17wid.6grLEE8G3\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e194e671-9f08-4fb3-8a7b-a0d904f77944", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02e34f9b-99a5-4af2-afbc-6a38c31baa3f", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8465a79d-b491-4ee1-8c23-8ef8d8690f95", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"Requested reserved rate limit will exceed the maximum.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7916dcbb-884e-454c-80c2-3ba255dae7ef", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"application_key\",\n \"name\": \"Batch-Processing\",\n \"reserved_rate_limit\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e49f01fb-a4c3-43b9-a025-21a9d8fc4f5d", "name": "Delete an Application Key", "request": { "name": "Delete an Application Key", "description": { "content": "Delete an Application Key", "type": "text/plain" }, "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "267f34e5-40b9-432a-8831-c4ce217e7bee", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "76ee4df4-dc29-4fc6-98c0-a5643896e66c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbc9d38c-9fcb-44c4-90a1-0006aeb02f86", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eea17da0-a1e4-42e5-a42f-b5ece6535b39", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "application-keys", ":application-key-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Application Key.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "application-key-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "id": "b6bb32fb-f935-4a0d-bb85-d6c5593cba4d", "name": "Get the Merchant Realm Mapping for the current store", "request": { "name": "Get the Merchant Realm Mapping for the current store", "description": { "content": "This API is used to obtain an [Authentication Realm](/docs/api/single-sign-on/authentication-realms) if there is none yet for the current store.\n", "type": "text/plain" }, "url": { "path": [ "v2", "merchant-realm-mappings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6a5cea55-f093-4768-abb8-b9245c6bb040", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"prefix\": \"myCompany\",\n \"type\": \"string\",\n \"realm_id\": \"e730bf37-ed95-4ca9-b4c4-2c5ee08b21d7\",\n \"store_id\": \"88888888-4444-4333-8333-111111111111\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "329d5d2b-53ad-4bd2-8f6c-d6ac47d415eb", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9423286b-d9aa-408b-a785-7188a444abdd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f13235e4-78bf-405f-a64b-ddea940c918a", "name": "Get a Merchant Realm Mapping", "request": { "name": "Get a Merchant Realm Mapping", "description": {}, "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id", "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b8aef478-1780-4a44-b8a0-81d61d63a2f2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"prefix\": \"myCompany\",\n \"type\": \"string\",\n \"realm_id\": \"e730bf37-ed95-4ca9-b4c4-2c5ee08b21d7\",\n \"store_id\": \"88888888-4444-4333-8333-111111111111\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a40599d7-2109-4a01-a193-cea3929f6b47", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"merchant realm mapping not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0e1d5f5-3d46-4e4b-90e9-1a00d39af2d9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e33b627-dab4-4e5a-94cf-981abcef9978", "name": "Update a Merchant Realm Mapping", "request": { "name": "Update a Merchant Realm Mapping", "description": {}, "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id", "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9780dc67-1010-45dc-bfe2-03db1b65abec", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"prefix\": \"myCompany\",\n \"type\": \"string\",\n \"realm_id\": \"e730bf37-ed95-4ca9-b4c4-2c5ee08b21d7\",\n \"store_id\": \"88888888-4444-4333-8333-111111111111\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12101a71-1131-4be9-b3f8-af2bbc2d7de2", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The field 'prefix' is required.\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "778ee819-4ace-47b3-b3e8-31ca0799fad3", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"merchant realm mapping not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbc14351-1430-48bf-8114-5de11617977b", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"the prefix is already in use\",\n \"status\": \"409\",\n \"title\": \"Conflict\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ece482f-51f0-4f5e-9c6e-8d7a280e86b0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "merchant-realm-mappings", ":mapping_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Application Key.", "type": "text/plain" }, "type": "any", "value": "0c45e4ec-26e0-4043-86e4-c15b9cf985a0", "key": "mapping_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"prefix\": \"myCompany\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "Catalogs", "description": "A catalog contains the products available for sale either in your organization or store. A catalog also contains information about how to organize those products for navigation menus and search facets in a shopper experience.\n\nBefore you create a catalog you must define the following resources:\n\n- Hierarchies: hierarchies and nodes to categorize the products. See [**Hierarchies**](/docs/api/pxm/products/hierarchies).\n- Products: product information, associated assets, and links to hierarchy nodes. See [**Products**](/docs/api/pxm/products/products).\n- Price Books: prices for the products associated with the hierarchies. See [**Price Books**](/docs/api/pxm/pricebooks).\n\nA catalog is a combination of hierarchies and a price book.\n\n### Products\n\nCommerce automatically assigns types to the products you create. Product types can be used in catalogs. For example, in your catalog, you can filter on `parent` so that only your parent products are displayed in your storefront.\n\nYou can use product tags to store or assign a key word against a product or service that you sell in your store. The product tag can then be used to describe or label that product. Product tags represent similarities between products who do not share the same attributes. Using product tags means that you can group your products together, for example, by brand, category, subcategory, colors, types, industries, and so on. Product tags can be used in catalogs. For example, you can categorize your products based on color. Your shoppers can then search your products by color, enabling shoppers to quickly find what they are looking for, increasing the likelihood of a purchase, and boosting conversion rates.\n\n### Hierarchies\n\nThe hierarchies determine which products appear in the catalog, that is, only the products that are associated with the selected hierarchies are included in the catalog. You can also specify the order you want your hierarchies to display in a published catalog. You can order your hierarchies on a catalog-by-catalog basis.\n\n![Hierarchy_sorting](/assets/hierarchy_sorting.png)\n\nFor more information, see [**create a Catalog**](/docs/api/pxm/catalog/create-catalog).\n\n#### Understanding How Products And Nodes Are Associated\n\nYou can use `breadcrumb` metadata to understand how products and nodes are associated. it explains how products are associated with parent nodes and the relationship among the array of nodes. This is useful if you want to improve how your shoppers search within your store.\n\nThe `breadcrumb` information that you get in an endpoint response depends on whether the endpoint is retrieving product or node details.\n\n| Object | Product/Node | Description |\n| --- | --- | --- |\n| `breadcrumb` | Node | A list of nodes that a product is associated with. Up to 10 levels of nodes are displayed, depending on the number of levels of nodes you have. |\n| `bread_crumbs` | Product | The relationship among the array of nodes a product is associated with, demonstrating the linking of the children nodes with the parent nodes. Up to 10 levels of nodes are displayed, depending on the number of levels of nodes you have. |\n| `bread_crumb_nodes` | Product | An array of parent node IDs that a product is associated with. The `bread_crumb_node` metadata lists up to 10 levels of parent nodes, depending on the number of levels of parent nodes you have. |\n\n#### Understanding `bread_crumbs` Metadata\n\nThe following diagram illustrates a parent and child nodes.\n\n![Breadcrumbs](/assets/breadcrumbs.PNG)\n\n1. The product is in **Node 2**. The ID for **Node 2** is shown first in the first set of breadcrumbs.\n1. **Node 2** is part of **Hierarchy 1**. The ID for **Hierarchy 1** is shown second.\n1. **Node 1** is the parent node of **Node 2**. The ID for **Node 1** is shown last.\n1. The product is also in **Node 3**. The ID for **Node 3** is shown first in the second set of breadcrumbs.\n1. **Node 3** is in the root of **Hierarchy 1**. The ID for **Hierarchy 1** is shown last.\n\nIn the `bread_crumb_nodes` metadata, you can see a list of parent nodes a product is associated with.\n\nIf you subsequently add a product to a new node, then the `bread_crumb_nodes` metadata appends the new node to the top of the list. Using the example above, if we add the product to **Node 1**:\n\n1. The `bread_crumb_nodes` metadata is generated to show the new node appended to the top of the list.\n1. The `bread_crumbs` metadata is updated with the new node.\n\n#### Understanding Breadcrumb Metadata for Child Products\n\nWhen a catalog is published, the breadcrumb information for a child product includes the metadata mentioned for the parent product, in addition to the information specific to the child product. For example, **Product A** is the parent product, associated with **Node 1** and **Node 2**. The metadata for child **Product B** includes **Node 1** and **Node 2**, in addition to its own metadata information.\n\n### Nodes\n\nThe nodes determine which products appear under this in the catalog, that is, only the products that are associated with the selected node are shown under this node.\n\n### Price books\n\nA price book contains the prices for each of the products in the catalog. You can create multiple price books for different scenarios, such as seasonal sales, business versus retail customer pricing, and reward programs. When creating a catalog, you can specify up to five price books. You must set a priority for your price books. Product prices are displayed in the catalog according to the priority of the price books. See [Create a catalog](/docs/api/pxm/catalog/create-catalog).\n", "item": [ { "id": "3fdfffb1-6d97-4699-9c61-4e313e14bcac", "name": "Creates a new catalog", "request": { "name": "Creates a new catalog", "description": { "content": "Before you create a catalog, you must define the following resources:\n\n- Hierarchies - hierarchies and nodes to categorize the products.\n- Products - product information, associated assets, and links to hierarchy nodes.\n- Price Books - prices for the products associated with the hierarchies. You can create multiple price books for different scenarios, such as seasonal sales, business versus retail customer pricing, and reward programs. When creating a catalog, you can specify up to five price books. You must configure a priority for your price books. Product prices are displayed in the catalog according to the priority of the price books. Priority is a number and the price book with the highest number has the highest priority.\n", "type": "text/plain" }, "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5212,\n \"id\": \"bb54d1f5-d40b-a0ae-9e5d-db15751d7566\"\n },\n {\n \"priority\": 9692,\n \"id\": \"2a9c85b0-e17d-9cfe-2a36-bb4364829c00\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "17cbbf29-97d6-451d-bfbe-7e1f5397bff7", "name": "The created catalog", "originalRequest": { "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5212,\n \"id\": \"bb54d1f5-d40b-a0ae-9e5d-db15751d7566\"\n },\n {\n \"priority\": 9692,\n \"id\": \"2a9c85b0-e17d-9cfe-2a36-bb4364829c00\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5456,\n \"id\": \"890b58d3-ffaa-d5c5-19db-e01ff9e0e082\"\n },\n {\n \"priority\": 6730,\n \"id\": \"381484e7-67da-f28a-fd3b-2d72f69aaad4\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"key_1\": {\n \"key_0\": \"string\"\n },\n \"key_2\": {\n \"key_0\": \"string\"\n },\n \"key_3\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"owner\": \"store\",\n \"enable_price_segmentation\": true\n },\n \"relationships\": {\n \"rules\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"releases\": {\n \"links\": {\n \"related\": \"string\"\n },\n \"meta\": {\n \"count\": 5585\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://JKPAEifYrIv.goumNO+prdLwP8wXJpZi4EHMQdYj\",\n \"first\": \"https://MRYIjiyJRQayGIyjikFFJWhGdYOf.bbuNNWLZTlA-nq,XlIgleomr4esaiRnE\",\n \"last\": \"http://GIEV.bzaqJqb3eCMqbOR,Pq5zKP+F\",\n \"prev\": \"https://ZQxha.cnookBSX8c30Z.OEB2sEuPGaF8t95XHuVZpu3iMIqJ6++JTx0UxYR2xnLS6PMhMAGcXD+BSfs4B.48+-\",\n \"next\": \"https://oUuQj.slHsSXKMOPQXBxpvXSmlT+U3.CGvgnP\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12d6b8a6-32c9-49a9-b5db-2d503b07cea2", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5212,\n \"id\": \"bb54d1f5-d40b-a0ae-9e5d-db15751d7566\"\n },\n {\n \"priority\": 9692,\n \"id\": \"2a9c85b0-e17d-9cfe-2a36-bb4364829c00\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f94275d8-c4d2-4c8f-85a1-d1a14b228343", "name": "Gets all authorized catalogs", "request": { "name": "Gets all authorized catalogs", "description": { "content": "Retrieves a list of all the catalogs that you are authorized to view. Currently, published catalogs are limited to the current release and two releases prior to the current release. You can see the differences between the last 2 consecutive catalog releases using the delta link returned in the response of a [publish a catalog](/docs/api/pxm/catalog/publish-release) endpoint.\n\nYou can use the `is_full_delta` attribute returned from the `get a release of a catalog` endpoint to determine if you need to refresh the data in your company system before publishing a catalog release and injecting fresh data in a delta link. The `is_full_delta` attribute tells you if this is a full publish of a catalog release. Using a search service as an example, if the `is_full_delta` attribute is `true`, you should remove all data about that catalog from the search service before publishing a catalog release and injecting fresh data from the delta file. See [Publish a catalog](/docs/api/pxm/catalog/publish-release).\n\nIf the `is_full_publish` attribute returned in the response is `false`, data from the previous catalog release overlaid the existing data in the delta file. The `is_full_publish` attribute is always `true` the first time a catalog is published. When determining whether delta data needs to be refreshed, ignore this attribute and always use the `is_full_delta` attribute.\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, | `filter=eq(name,some-name)` |\n| `in` | Checks if the values are included in the specified list. If they are, the condition is true. | `name` | `filter=in(name,some-name,some-name2)` |\n| `like` | Checks if the operand contains the specified string. Wildcards are supported | `name` | `filter=like(name,*some-name*)` |\n", "type": "text/plain" }, "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b66151d8-12f4-48a2-90e0-3ef2b236a7cd", "name": "The list of catalogs.", "originalRequest": { "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 6464,\n \"id\": \"78f52b98-b51d-9469-9529-078880340b3b\"\n },\n {\n \"priority\": 7803,\n \"id\": \"5f5f3056-5c9e-2769-3a8e-653fe1191fe2\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"key_1\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"key_2\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"key_3\": {\n \"key_0\": \"string\"\n }\n },\n \"owner\": \"store\",\n \"enable_price_segmentation\": true\n },\n \"relationships\": {\n \"rules\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"releases\": {\n \"links\": {\n \"related\": \"string\"\n },\n \"meta\": {\n \"count\": 2866\n }\n }\n }\n },\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 4659,\n \"id\": \"4933b009-bd7a-820a-16aa-ad376c9e057b\"\n },\n {\n \"priority\": 8572,\n \"id\": \"0c5a3d82-1d97-f513-0d75-0a0964af7bdd\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\"\n }\n },\n \"owner\": \"store\",\n \"enable_price_segmentation\": true\n },\n \"relationships\": {\n \"rules\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"releases\": {\n \"links\": {\n \"related\": \"string\"\n },\n \"meta\": {\n \"count\": 1772\n }\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 8808\n },\n \"page\": {\n \"limit\": 5750,\n \"offset\": 5718,\n \"current\": 4635,\n \"total\": 7080\n }\n },\n \"links\": {\n \"self\": \"http://NUQMGofekdzoXXwOUtEJDmW.chXIoDRignvXGHK.Ntzs+zgd5i7Pvn\",\n \"first\": \"http://TElnnbFWlfpOXxwhqUrnEzTyaFp.rjgKYdd.wH+pJXNC8W7OwHaWaSwShoJghvbWfwdGLXVMF\",\n \"last\": \"https://HbTgUeARk.puzbEytVNEbao4HbpLJVS+2l-mXmIZrrfpQpSgTBNZbf\",\n \"prev\": \"http://XVntpZvUquAvyXVWmcWvU.dyjyB7TV1.phWztMshWUJ1ge,rGeX4rKs4GEy\",\n \"next\": \"http://XfRlxjiRPj.wwgbf-DBKeXPjjJlYUuIWW+pD8Qy-waKtDw8XRyjh0zP1gMizDXt\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62a3f609-c1e5-46f7-b30a-cea16e461766", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4e79bc11-dbf0-4049-8c00-460af9ce4f90", "name": "Get a catalog by ID", "request": { "name": "Get a catalog by ID", "description": { "content": "Retrieves the specified catalog.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4bd0d83a-26cd-47f8-b2f6-0a98623fc323", "name": "The catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5456,\n \"id\": \"890b58d3-ffaa-d5c5-19db-e01ff9e0e082\"\n },\n {\n \"priority\": 6730,\n \"id\": \"381484e7-67da-f28a-fd3b-2d72f69aaad4\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"key_1\": {\n \"key_0\": \"string\"\n },\n \"key_2\": {\n \"key_0\": \"string\"\n },\n \"key_3\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"owner\": \"store\",\n \"enable_price_segmentation\": true\n },\n \"relationships\": {\n \"rules\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"releases\": {\n \"links\": {\n \"related\": \"string\"\n },\n \"meta\": {\n \"count\": 5585\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://JKPAEifYrIv.goumNO+prdLwP8wXJpZi4EHMQdYj\",\n \"first\": \"https://MRYIjiyJRQayGIyjikFFJWhGdYOf.bbuNNWLZTlA-nq,XlIgleomr4esaiRnE\",\n \"last\": \"http://GIEV.bzaqJqb3eCMqbOR,Pq5zKP+F\",\n \"prev\": \"https://ZQxha.cnookBSX8c30Z.OEB2sEuPGaF8t95XHuVZpu3iMIqJ6++JTx0UxYR2xnLS6PMhMAGcXD+BSfs4B.48+-\",\n \"next\": \"https://oUuQj.slHsSXKMOPQXBxpvXSmlT+U3.CGvgnP\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52dba92c-da87-4726-a54a-f9aeac938748", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6834a627-c62f-4120-9775-c8fe015b730b", "name": "Updates a catalog", "request": { "name": "Updates a catalog", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the catalog is not updated.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 2094,\n \"id\": \"7a2529b0-48cb-d6cd-34c7-b4f6137a1af9\"\n },\n {\n \"priority\": 8552,\n \"id\": \"61974064-3624-1b88-62fe-48e75be40704\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a382adfa-8e2e-43ec-a50f-fcfe87e2501f", "name": "An updated catalog with the following attributes.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 2094,\n \"id\": \"7a2529b0-48cb-d6cd-34c7-b4f6137a1af9\"\n },\n {\n \"priority\": 8552,\n \"id\": \"61974064-3624-1b88-62fe-48e75be40704\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog for Store 123\",\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 5456,\n \"id\": \"890b58d3-ffaa-d5c5-19db-e01ff9e0e082\"\n },\n {\n \"priority\": 6730,\n \"id\": \"381484e7-67da-f28a-fd3b-2d72f69aaad4\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"key_1\": {\n \"key_0\": \"string\"\n },\n \"key_2\": {\n \"key_0\": \"string\"\n },\n \"key_3\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"owner\": \"store\",\n \"enable_price_segmentation\": true\n },\n \"relationships\": {\n \"rules\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"releases\": {\n \"links\": {\n \"related\": \"string\"\n },\n \"meta\": {\n \"count\": 5585\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://JKPAEifYrIv.goumNO+prdLwP8wXJpZi4EHMQdYj\",\n \"first\": \"https://MRYIjiyJRQayGIyjikFFJWhGdYOf.bbuNNWLZTlA-nq,XlIgleomr4esaiRnE\",\n \"last\": \"http://GIEV.bzaqJqb3eCMqbOR,Pq5zKP+F\",\n \"prev\": \"https://ZQxha.cnookBSX8c30Z.OEB2sEuPGaF8t95XHuVZpu3iMIqJ6++JTx0UxYR2xnLS6PMhMAGcXD+BSfs4B.48+-\",\n \"next\": \"https://oUuQj.slHsSXKMOPQXBxpvXSmlT+U3.CGvgnP\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c9618c6-3f55-4aea-9446-f51854299a31", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog\",\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"catalog-123\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchy_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_id\": \"string\",\n \"pricebook_ids\": [\n {\n \"priority\": 2094,\n \"id\": \"7a2529b0-48cb-d6cd-34c7-b4f6137a1af9\"\n },\n {\n \"priority\": 8552,\n \"id\": \"61974064-3624-1b88-62fe-48e75be40704\"\n }\n ],\n \"locales\": {\n \"key_0\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n },\n \"enable_price_segmentation\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8d179952-5ced-46a5-9084-12371421a7c9", "name": "Deletes a catalog", "request": { "name": "Deletes a catalog", "description": { "content": "Deletes an unpublished catalog. Use [**Delete a Release**](/docs/api/pxm/catalog/delete-release-by-id) and [**Delete All Releases**](/docs/api/pxm/catalog/delete-releases) to delete releases of a catalog. If the catalog is associated with any catalog rules, you must first update the catalog rules to remove the catalog.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "8e4f3912-6c18-4053-8c3f-1c2023fbab11", "name": "A 204 response indicates that the catalog has been deleted.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f4a4b63e-5658-4161-acad-a485e8aab148", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Releases", "description": "When a catalog is published, a catalog release is created. A catalog release provides a snapshot of the product information taken at the time of publication. You can have one or more catalog releases available in your organization or in your store. If you publish a catalog for your organization, the catalog is available when the store is launched.\n\nIf you have more than one catalog published for your store, use catalog rules to specify when to display each catalog. For example, you can use [**catalog rules**](/docs/api/pxm/catalog/rules) to schedule a catalog to appear during a particular date and time, such as a seasonal catalog. The catalog may have different pricing than the other catalogs.\n\nWhen a catalog is ready to be used in a store, you publish it. You can create and publish catalogs for different contexts and channels.\n\nHere are some pointers to understand a catalogs' lifecycle.\n\n- The default catalog is always the oldest published catalog and must have have at least one release.\n- At any time, the most recent three catalog releases are maintained. Hence, if there is a fourth catalog release, the first catalog release is automatically removed.\n- Until the catalog is published again, the previously created three catalog releases stay permanently.\n- If you want any other catalog to become the default catalog, you must create a catalog rule.\n- If you want the oldest published catalog to become the default catalog, you must remove the catalog rule.\n- Use the `sort_order` value in the `variations` to program your storefront to display the variation options in the order that you want.\n\nHere is a diagram that describes a catalogs' lifecycle:\n\n![Catalogs' Lifecycle](/assets/catalog-lifecycle.png)\n\n### Publishing catalogs\n\nWhen you publish a catalog, the `live` products in the hierarchies appear in a catalog release. A catalog release provides a snapshot of product information taken at the time of publication. You can have one or more catalog releases available in your organization or in your store. If you publish a catalog for your organization, the catalog is available when the store is launched.\n\nIf you have more than one catalog published for your store, use catalog rules to specify when to display each catalog. For example, you can use [catalog rules](/docs/api/pxm/catalog/rules) to schedule a catalog to appear during a particular date and time, such as a seasonal catalog. The catalog may have different pricing than the other catalogs. You can have multiple published catalogs.\n\nWhen a catalog is ready to be used in a store, you publish it. You can create and publish catalogs for different contexts and channels. You can see the differences between the last two consecutive catalog releases. See [Publish a catalog](/docs/api/pxm/catalog/publish-release).\n\nYou retrieve catalogs for your shopper experience by using the [Catalog View API](/docs/api/pxm/catalog/releases).\n", "item": [ { "id": "a5245f1d-75b2-4cc7-b9ee-621491ed8643", "name": "Get the catalog release as shoppers", "request": { "name": "Get the catalog release as shoppers", "description": { "content": "Returns a list of all published releases of the specified catalog.", "type": "text/plain" }, "url": { "path": [ "catalog" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1bc7dcd1-4f36-4e7d-a9d0-d56d8f939973", "name": "The catalog.", "originalRequest": { "url": { "path": [ "catalog" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"Clothing\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"catalog_id\": \"0194f54d-f2a1-4e33-9a6e-9ec366152490\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchies\": [\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n },\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n }\n ]\n },\n \"relationships\": {\n \"delta\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchies\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"string\",\n \"meta\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"started_at\": \"1970-01-01T00:00:00.000\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"release_status\": \"IN_PROGRESS\",\n \"language\": \"en-GB\",\n \"is_full_publish\": false,\n \"is_full_delta\": false,\n \"total_products\": 3779,\n \"total_nodes\": 912,\n \"percent_completed\": 5715,\n \"owner\": \"store\",\n \"price_segmentation_enabled\": true\n }\n },\n \"links\": {\n \"self\": \"http://hluBuSsJkIDLYMdaOXgxXxFJHMmywciKn.plqmctBagSLcNFyRkR0kDwsiMioA7M4oUslNH34xngq4gR+.buSNf0\",\n \"first\": \"https://naKWFuMycFsEoiwUzSKrjeofkFapHPCW.jaqg1SYgjBfHwnuTRZAEDaMs\",\n \"last\": \"http://akdrsAhaaPkydfD.hbwcTW4.7lGQ5gFdF0feqy1P0f8gbRpm+\",\n \"prev\": \"https://EPlLC.dxlRoQHG4PxH\",\n \"next\": \"https://oPkt.ltqe+QqcAT3O,zAvz0YHBfokgWoBE3buFqrRQIid-\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04c5ac1f-8382-4f6f-915a-862da398ba97", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bf421249-3b74-4f47-99bb-112deee742b0", "name": "Publishes a catalog", "request": { "name": "Publishes a catalog", "description": { "content": "\nPublishes a catalog. You must publish a catalog before you can retrieve that catalog in an organization or store. The hierarchies, live products, and prices associated with a published catalog are in read-only mode. If you make a change to these resources, for example, a change to your price book or hierarchies, you need to republish the catalog.\n\nYou can get [a catalog release](/docs/api/pxm/catalog/get-release-by-id) to retrieve a published catalog. Currently, published catalogs are limited to the current release and two releases prior to the current release.\n\nYou can see the differences between the last 2 consecutive catalog releases. This is useful if want to understand how your products have changed in your catalog, ensuring your site search integration is kept up-to-date.\n\nOnce a catalog release has completed publishing, the delta relationship links to the delta document.\n\nThe `delta` links are signed and only valid for 1 hour. Re-reading a catalog release, for example, using [Getting a release of a catalog](/docs/api/pxm/catalog/get-release-by-id) returns a fresh a link.\n\nYou can use the `is_full_delta` attribute returned from the `get a release of a catalog` endpoint to determine if you need to refresh the data in your company system before injecting fresh data in a `delta` link. The `is_full_delta` attribute tells you if this is a full publish of the catalog. Using a search service as an example, if the `is_full_delta` attribute is `true`, you should remove all data about that catalog from the search service before injecting fresh data from the `delta` file. If the `is_full_delta` attribute is `false`, then data from the previous catalog overlays the existing data in the `delta` file. To publish a catalog and inject fresh data in a `delta` link, set `export_full_delta` to `true`.\n\nIf a previous catalog publish date is greater than 90 days, then a full catalog publish is automatically performed. If you publish your catalogs infrequently, Commerce may perform a full publish when you are expecting a delta publish.\n\n:::caution\n\nGenerating a full delta is resource intensive and slows down the publishing process and so should only be performed in certain circumstances, for example, when initializing an integration with a service like Algolia.\n\n:::\n\nThe `is_full_delta` attribute is always `true` the first time a catalog is published. The information is stored in a collection of `json` documents in a compressed file. You can either manually check the file or, for example, use them to automatically update another company system you may have.\n\n- Delta files are only available for 30 days.\n- Delta files are removed when a catalog release is deleted.\n\nEach document has a `delta_type` with one of the following values, depending on whether a product has been deleted, updated or created in a catalog release.\n\n- `delete` describes products deleted from this release of a catalog.\n- `createupdate` describes products updated in this release of a catalog.\n\n### Multi-Store Management Solutions\n\nIn a multi-store management solution.\n\n- You can create organization catalogs. Your organization catalogs are available for your stores to use.\n- Your stores can create their own catalogs.\n- Your stores can create catalogs that have a combination of organization products and store products.\n\nIf you are publishing a catalog in a store that contains resources from an organization, in Commerce Manager, you must enable the **Include Organization Resources in Catalog Publishes** checkbox.\n\n1. Go to **SYSTEM** > **Store Settings**.\n2. Click **General Settings**.\n3. Select **PXM** from the list.\n4. Select the **Include Organization Resources in Catalog Publishes** checkbox.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"export_full_delta\": true,\n \"include_organization_resources\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "14c03899-0196-4212-a538-28f818b02fb1", "name": "Publishes a catalog release with the following attributes.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"export_full_delta\": true,\n \"include_organization_resources\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"Clothing\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"catalog_id\": \"0194f54d-f2a1-4e33-9a6e-9ec366152490\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchies\": [\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n },\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n }\n ]\n },\n \"relationships\": {\n \"delta\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchies\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"string\",\n \"meta\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"started_at\": \"1970-01-01T00:00:00.000\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"release_status\": \"IN_PROGRESS\",\n \"language\": \"en-GB\",\n \"is_full_publish\": false,\n \"is_full_delta\": false,\n \"total_products\": 3779,\n \"total_nodes\": 912,\n \"percent_completed\": 5715,\n \"owner\": \"store\",\n \"price_segmentation_enabled\": true\n }\n },\n \"links\": {\n \"self\": \"http://hluBuSsJkIDLYMdaOXgxXxFJHMmywciKn.plqmctBagSLcNFyRkR0kDwsiMioA7M4oUslNH34xngq4gR+.buSNf0\",\n \"first\": \"https://naKWFuMycFsEoiwUzSKrjeofkFapHPCW.jaqg1SYgjBfHwnuTRZAEDaMs\",\n \"last\": \"http://akdrsAhaaPkydfD.hbwcTW4.7lGQ5gFdF0feqy1P0f8gbRpm+\",\n \"prev\": \"https://EPlLC.dxlRoQHG4PxH\",\n \"next\": \"https://oPkt.ltqe+QqcAT3O,zAvz0YHBfokgWoBE3buFqrRQIid-\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b25fcea4-2e55-4ae5-b653-1559c583ade5", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"export_full_delta\": true,\n \"include_organization_resources\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3a768485-3265-4cac-9d5e-f2eeb2ccc223", "name": "Gets all authorized catalog releases", "request": { "name": "Gets all authorized catalog releases", "description": { "content": "Returns a list of all published releases of the specified catalog. Currently, published catalogs are limited to the current release and two releases prior to the current release. You can see the differences between the last 2 consecutive catalog releases using the `delta` link returned in the response of a `publish a catalog` endpoint.\n\nYou can use the `is_full_delta` attribute returned from the `get a release of a catalog` endpoint to determine if you need to refresh the data in your company system before publishing a catalog release and injecting fresh data in a delta link. The `is_full_delta` attribute tells you if this is a full publish of a catalog release. Using a search service as an example, if the `is_full_delta` attribute is `true`, you should remove all data about that catalog from the search service before publishing a catalog release and injecting fresh data from the delta file. \n\nIf the `is_full_publish` attribute returned in the response is `false`, data from the previous catalog release overlaid the existing data in the delta file. The `is_full_publish` attribute is always `true` the first time a catalog is published. When determining whether delta data needs to be refreshed, ignore this attribute and always use the `is_full_delta` attribute.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2b7c5383-79e4-4cf3-a4aa-51af6ca25036", "name": "The list of catalogs.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"Clothing\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"catalog_id\": \"0194f54d-f2a1-4e33-9a6e-9ec366152490\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchies\": [\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n },\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n }\n ]\n },\n \"relationships\": {\n \"delta\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchies\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"string\",\n \"meta\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"started_at\": \"1970-01-01T00:00:00.000\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"release_status\": \"FAILED\",\n \"language\": \"en-GB\",\n \"is_full_publish\": false,\n \"is_full_delta\": false,\n \"total_products\": 7852,\n \"total_nodes\": 9746,\n \"percent_completed\": 686,\n \"owner\": \"organization\",\n \"price_segmentation_enabled\": true\n }\n },\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"Clothing\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"catalog_id\": \"0194f54d-f2a1-4e33-9a6e-9ec366152490\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchies\": [\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n },\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n }\n ]\n },\n \"relationships\": {\n \"delta\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchies\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"string\",\n \"meta\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"started_at\": \"1970-01-01T00:00:00.000\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"release_status\": \"IN_PROGRESS\",\n \"language\": \"en-GB\",\n \"is_full_publish\": false,\n \"is_full_delta\": false,\n \"total_products\": 2019,\n \"total_nodes\": 3245,\n \"percent_completed\": 935,\n \"owner\": \"store\",\n \"price_segmentation_enabled\": false\n }\n }\n ],\n \"links\": {\n \"self\": \"https://fnPSJuaXylcLOijvignsPPIOJOUIlJpZ.reGpsSM+n5F0Z\",\n \"first\": \"http://DXdqoMVHdFDYwvu.qtCkgBURZylZUf3XAKnjqPclZeRDC4saHqiDQgp2BTR3kA7\",\n \"last\": \"https://BzTtemymTQZOcONmcNgoynPVnnAeW.kcwH47l+Nx,nwirOXIiHEiH9PF7NdlAc2cYpZbg.gpVZfqP-+zPE6Yc\",\n \"prev\": \"http://ZPSpTX.yeVeCVhNQSkXTeoeT-7AMX8LXgOyh\",\n \"next\": \"http://VCeemuOpXL.sgzuDRddCoThdgNnsp5sTN6Cr6LU5sqH.ewO5l1.WSN7qZaCq4zmRcjUM,4\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47677913-7a74-4b8d-970c-94668b60c7e1", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "17a6f879-8714-4755-8597-f04c205f8ebe", "name": "Deletes all releases", "request": { "name": "Deletes all releases", "description": { "content": "Deletes all releases of the specified published catalog.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "54db73af-7c9f-4224-a774-9ba788d99bb1", "name": "A 204 response indicates that the releases have been deleted.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7efb8289-0a9d-4770-af50-6a95bf346270", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5976d57b-bb50-424a-80ca-dc62c6d01f27", "name": "Get a catalog release by ID", "request": { "name": "Get a catalog release by ID", "description": { "content": "Retrieves the specified catalog release.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "57fcb43f-2234-4545-9037-a8003fa74420", "name": "The catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"attributes\": {\n \"name\": \"Clothing\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"catalog_id\": \"0194f54d-f2a1-4e33-9a6e-9ec366152490\",\n \"description\": \"Catalog for Store 123\",\n \"hierarchies\": [\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n },\n {\n \"id\": \"65477ce0-fcb8-436b-a120-3d57979421dd\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\"\n }\n ]\n },\n \"relationships\": {\n \"delta\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchies\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"string\",\n \"meta\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"started_at\": \"1970-01-01T00:00:00.000\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"release_status\": \"IN_PROGRESS\",\n \"language\": \"en-GB\",\n \"is_full_publish\": false,\n \"is_full_delta\": false,\n \"total_products\": 3779,\n \"total_nodes\": 912,\n \"percent_completed\": 5715,\n \"owner\": \"store\",\n \"price_segmentation_enabled\": true\n }\n },\n \"links\": {\n \"self\": \"http://hluBuSsJkIDLYMdaOXgxXxFJHMmywciKn.plqmctBagSLcNFyRkR0kDwsiMioA7M4oUslNH34xngq4gR+.buSNf0\",\n \"first\": \"https://naKWFuMycFsEoiwUzSKrjeofkFapHPCW.jaqg1SYgjBfHwnuTRZAEDaMs\",\n \"last\": \"http://akdrsAhaaPkydfD.hbwcTW4.7lGQ5gFdF0feqy1P0f8gbRpm+\",\n \"prev\": \"https://EPlLC.dxlRoQHG4PxH\",\n \"next\": \"https://oPkt.ltqe+QqcAT3O,zAvz0YHBfokgWoBE3buFqrRQIid-\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e2ae63a-6c57-486a-9076-3535df513088", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b4d5a66e-7ecd-41bf-9d60-f331ffda7404", "name": "Deletes a release", "request": { "name": "Deletes a release", "description": { "content": "Deletes the specified published catalog release.", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "b0b73105-8091-4e31-b76a-f69798d62fed", "name": "A 204 response indicates that the release has been deleted.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3f65f169-cf6a-47c2-9338-9d2963144b13", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rules", "description": "If your store requires multiple catalogs, add catalog rules to control when a catalog is displayed. A catalog rule contains a catalog plus the criteria under which to display the catalog.\n\n:::caution\n\nYou cannot create catalog rules for organization catalogs.\n\n:::\n\nYou can use catalog rules to schedule a catalog to appear during a particular period, such as on a specific date or during summer. The catalog might offer different pricing during this period. The pricing depends on the associated price book.\n\nThe following scenarios provides a few examples for using catalog rules.\n\n- **Multiple geographical regions**. Display different catalogs in different regions with suitable pricing or combine product hierarchies from two different regions to display in a third region.\n- **Multiple channels**. Display different catalogs based on how a shopper accesses your store, such as through a mobile app or a web storefront.\n- **Direct to business versus direct to customers**. Offer different products and prices for business customers versus retail customers.\n- **Preferred accounts**. Offer special pricing to a group of users while displaying a standard price catalog to other users.\n- **Preferred customers**. Offer special pricing to preferred customers while displaying a standard price catalog to all other shoppers.\n- **Reward programs**. Enable reward programs where catalog prices drop after a certain spending level is reached.\n- **Product sales**. Offer sale items for a limited time.\n- **Standard pricing**. Display a default catalog to the shoppers who do not meet the criteria of the other catalog rules.\n\nYou can define a catalog rule with any of the following criteria.\n\n- **Accounts**. List the accounts that should see a catalog. When a user has logged in with the account, they see the configured catalog.\n- **Customers**. List the customers that should see a catalog. When the customer is logged in, they see the configured catalog.\n- **Channel**. Specify a shopper experience, such as web storefront or mobile app. Set up the channel to retrieve the catalog from the catalog rule that matches that channel.\n- **Other tags**. Create your own user-defined tags. For example, you might want to tag by regions or you might want to distinguish between business and consumer customers.\n\nIf a catalog rule has no criteria defined, it is the default catalog rule.\n\n### Resolving catalog rules\n\nWhen there is a request for a catalog, the store displays the catalog with the rule that matches the most attributes of the shoppers context.\n\nThe request triggers the following steps:\n\n1. Compares the shoppers context against the defined catalog rules.\n1. Determines the best match.\n1. Retrieves the catalog associated with the matching catalog rule.\n\nThe follow examples show how the best match might be resolved:\n\n- A shopper matches one of the `customer_ids` in one catalog rule only. The catalog for that catalog rule is displayed.\n- A shopper matches one of the `customer_ids` in one catalog rule only, but doesnʼt match any of the `tags` specified in that catalog rule. Because there are no other catalog rules for this `customer_id`, the catalog for the catalog rule is displayed because it is the best match.\n- A shopper is browsing a store using the stores mobile app, which matches `channel=mobile` in two catalog rules. The catalog displayed depends on matches with the `tags` or `customer_ids` attributes. If there is no other matching attribute, the first catalog rule found by the store is used. The best practice is to create catalog rules that cover all cases so that you avoid this situation.\n- An unknown shopper is browsing the only channel offered by the seller. The store displays the base catalog.\n", "item": [ { "id": "d4e87138-e9ca-48e3-bbc6-852a52eed21a", "name": "Creates a new catalog rule", "request": { "name": "Creates a new catalog rule", "description": { "content": "If you have multiple catalogs, create catalog rule resources. With catalog rules, you can display different catalogs to different shoppers. For example, you can display a preferred pricing catalog to a few special customers. Or you can display one catalog to shoppers using your website and a different catalog to shoppers using your mobile app. Finally, you can define custom criteria by creating tags.\n\n:::note\n\n- If you have one catalog for all customers and channels, you can omit creating this resource.\n- Due to the way catalogs are cached in Commerce, using catalog rules to display catalogs sometimes causes a 5-minute time delay before the catalogs are displayed.\n- You cannot create catalog rules for organization catalogs.\n\n:::\n\nFor ideas about the kinds of business scenarios you can achieve with catalog rules, see [Catalog Rules](/docs/api/pxm/catalog/rules). To understand how catalogs are matched to shoppers by using rules, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 3206,\n \"id\": \"008bef96-ac53-f94c-27a8-18ef603ed390\"\n },\n {\n \"priority\": 9168,\n \"id\": \"8492cca2-bc20-594c-4176-d422a737ac84\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "df8c6502-b8da-4450-97c0-fda999bcca96", "name": "The created catalog rule", "originalRequest": { "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 3206,\n \"id\": \"008bef96-ac53-f94c-27a8-18ef603ed390\"\n },\n {\n \"priority\": 9168,\n \"id\": \"8492cca2-bc20-594c-4176-d422a737ac84\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 7168,\n \"id\": \"0dbb1309-eacf-d3eb-ff88-f99f1039b1e9\"\n },\n {\n \"priority\": 3188,\n \"id\": \"6c44a7c6-4a51-c895-c153-9dbdd029e303\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n },\n \"links\": {\n \"self\": \"http://skUC.zhdffb+vyOIgAAwXUXurHCRnEe5BNSEvlPTIibNOL7fTI0kSSrnq5KaC\",\n \"first\": \"http://cWwHC.nnuymuyW57.MkDwtH.GxjsHU4ECf6P0fzBGBZM88V2yYk-U,J3O.Bx5VT2rHOU-2O4SD,BF5s+\",\n \"last\": \"http://LsShJAACioOcNtSduUSKBEEC.enj956OBxA29Nkh.S\",\n \"prev\": \"https://HDdd.uwlZ9hwybkATkQRrVSMQfkC4apCZHokD7PmJWdBD9oXiYSWDkvuGyys1DzxuiZj\",\n \"next\": \"http://NLIAbsgQNxwKNzIWxwa.lmoCsdDQ5mEBw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8910820-adec-4119-843f-d8971c6539cd", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 3206,\n \"id\": \"008bef96-ac53-f94c-27a8-18ef603ed390\"\n },\n {\n \"priority\": 9168,\n \"id\": \"8492cca2-bc20-594c-4176-d422a737ac84\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ff7d9fcd-c8ab-4b92-8677-5f2bca28732e", "name": "Gets all authorized catalog rules", "request": { "name": "Gets all authorized catalog rules", "description": { "content": "Retrieves all authorized catalog rules.\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are supported.\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `eq` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. | `id`,`catalog_id`,`account_ids`,`customer_ids`,`channels`,`tags`,`pricebook_ids` | `filter=eq(id,some-id)` | \n| `in` | Checks if the values are included in the specified string. If they are, the condition is true. | `id`,`account_ids`,`customer_ids`,`channels`,`tags`,`pricebook_ids` | `filter=in(account_ids,some-id,another-id)` | \n", "type": "text/plain" }, "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "919b43b3-8dd0-41fb-8602-88f9563c3d3a", "name": "The list of catalog rules.", "originalRequest": { "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 5230,\n \"id\": \"80b355f2-7e68-f245-5b6c-d8ff2c2804a4\"\n },\n {\n \"priority\": 8065,\n \"id\": \"32a4e6c3-63c1-3f2b-4b42-b5a9a074c38c\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n },\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 3132,\n \"id\": \"ef31bc26-67a8-4764-98e2-e5f18afab45b\"\n },\n {\n \"priority\": 7986,\n \"id\": \"b2b2c713-6912-fc22-aee6-05fd1edcf18a\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 7089\n },\n \"page\": {\n \"limit\": 7924,\n \"offset\": 2560,\n \"current\": 2046,\n \"total\": 8123\n }\n },\n \"links\": {\n \"self\": \"https://wroH.gtTY0a0ziIHMzzU,xqag6tYtdwGGFE8ZC9odsr1IjtW\",\n \"first\": \"https://HXeer.wkqQ8cg8b5m,9Heh8K.yMo6LeZ,ZD8Py.XpeA-R5TOmK.mH.FoXQVe,C+a-eP\",\n \"last\": \"https://pEyg.cutyJ8qW3\",\n \"prev\": \"http://CQBffYzBZbfGr.lluSQMlUfmiPh4.obHccNh7w2bZp7sCqbuVmPJgNdKxbGIWpVG2PW\",\n \"next\": \"https://zcynn.pljiuTS+pQQondNw0m6aWmUyS-iYOROWeKc6R\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f903d662-732e-4cfc-b9f0-e9ec6d811828", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd403b52-e8e1-4d45-8fa6-3b0ec306c130", "name": "Get a catalog rule by ID", "request": { "name": "Get a catalog rule by ID", "description": {}, "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_rule_id", "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1f024e2d-75d2-4805-8d53-157cc0d61146", "name": "The catalog rile.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 7168,\n \"id\": \"0dbb1309-eacf-d3eb-ff88-f99f1039b1e9\"\n },\n {\n \"priority\": 3188,\n \"id\": \"6c44a7c6-4a51-c895-c153-9dbdd029e303\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n },\n \"links\": {\n \"self\": \"http://skUC.zhdffb+vyOIgAAwXUXurHCRnEe5BNSEvlPTIibNOL7fTI0kSSrnq5KaC\",\n \"first\": \"http://cWwHC.nnuymuyW57.MkDwtH.GxjsHU4ECf6P0fzBGBZM88V2yYk-U,J3O.Bx5VT2rHOU-2O4SD,BF5s+\",\n \"last\": \"http://LsShJAACioOcNtSduUSKBEEC.enj956OBxA29Nkh.S\",\n \"prev\": \"https://HDdd.uwlZ9hwybkATkQRrVSMQfkC4apCZHokD7PmJWdBD9oXiYSWDkvuGyys1DzxuiZj\",\n \"next\": \"http://NLIAbsgQNxwKNzIWxwa.lmoCsdDQ5mEBw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dad5e444-32aa-465f-8ebf-45b1221fa7f5", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dc71d44d-f474-40e5-811c-6a1b625c730f", "name": "Updates a catalog rule", "request": { "name": "Updates a catalog rule", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the catalog rule is not updated.", "type": "text/plain" }, "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_rule_id", "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"pricebook_ids\": [\n {\n \"priority\": 7130,\n \"id\": \"3d0111cc-e546-7f11-0e2e-5f56fdf02135\"\n },\n {\n \"priority\": 3546,\n \"id\": \"2ca44f42-d782-6812-895a-70c767117953\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7dc13ed7-2960-4e3d-bdb0-8d81780705ab", "name": "An Updated catalog rule with the following attributes.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"pricebook_ids\": [\n {\n \"priority\": 7130,\n \"id\": \"3d0111cc-e546-7f11-0e2e-5f56fdf02135\"\n },\n {\n \"priority\": 3546,\n \"id\": \"2ca44f42-d782-6812-895a-70c767117953\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 7168,\n \"id\": \"0dbb1309-eacf-d3eb-ff88-f99f1039b1e9\"\n },\n {\n \"priority\": 3188,\n \"id\": \"6c44a7c6-4a51-c895-c153-9dbdd029e303\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n },\n \"links\": {\n \"self\": \"http://skUC.zhdffb+vyOIgAAwXUXurHCRnEe5BNSEvlPTIibNOL7fTI0kSSrnq5KaC\",\n \"first\": \"http://cWwHC.nnuymuyW57.MkDwtH.GxjsHU4ECf6P0fzBGBZM88V2yYk-U,J3O.Bx5VT2rHOU-2O4SD,BF5s+\",\n \"last\": \"http://LsShJAACioOcNtSduUSKBEEC.enj956OBxA29Nkh.S\",\n \"prev\": \"https://HDdd.uwlZ9hwybkATkQRrVSMQfkC4apCZHokD7PmJWdBD9oXiYSWDkvuGyys1DzxuiZj\",\n \"next\": \"http://NLIAbsgQNxwKNzIWxwa.lmoCsdDQ5mEBw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69fac1e0-5cdb-44cb-bb86-d9025f6cff1b", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"pricebook_ids\": [\n {\n \"priority\": 7130,\n \"id\": \"3d0111cc-e546-7f11-0e2e-5f56fdf02135\"\n },\n {\n \"priority\": 3546,\n \"id\": \"2ca44f42-d782-6812-895a-70c767117953\"\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "366469e4-9d47-4771-9185-2eb8ee88b434", "name": "Deletes a catalog rule", "request": { "name": "Deletes a catalog rule", "description": {}, "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_rule_id", "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "f8713fc0-6f60-4afc-a549-97f2089f90a5", "name": "A 204 response indicates that the catalog rule has been deleted.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "680c0063-fa17-4db7-ab92-04b15fae7c6d", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules", ":catalog_rule_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog rule ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_rule_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "989f5bd6-41e8-44fc-ba6a-ef3ec88308f1", "name": "Validate catalog rules for a given context", "request": { "name": "Validate catalog rules for a given context", "description": { "content": "Validates catalog rules for a given context and returns a list of matching catalog rules.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", "rules", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"match_type\": \"resolve_for_shopper\",\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_ids\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2013-10-09T06:54:57.487Z\",\n \"valid_to\": \"1969-03-10T21:22:55.175Z\"\n },\n {\n \"valid_from\": \"1971-08-04T22:42:50.913Z\",\n \"valid_to\": \"1970-02-14T04:08:40.091Z\"\n }\n ],\n \"name\": \"string\",\n \"catalog_id\": \"string\",\n \"match_date\": \"1960-01-03T09:00:06.648Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c129bf18-e612-4cf7-8fab-4a289be96ebb", "name": "List of matching catalog rules", "originalRequest": { "url": { "path": [ "catalogs", "rules", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"match_type\": \"resolve_for_shopper\",\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_ids\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2013-10-09T06:54:57.487Z\",\n \"valid_to\": \"1969-03-10T21:22:55.175Z\"\n },\n {\n \"valid_from\": \"1971-08-04T22:42:50.913Z\",\n \"valid_to\": \"1970-02-14T04:08:40.091Z\"\n }\n ],\n \"name\": \"string\",\n \"catalog_id\": \"string\",\n \"match_date\": \"1960-01-03T09:00:06.648Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 5230,\n \"id\": \"80b355f2-7e68-f245-5b6c-d8ff2c2804a4\"\n },\n {\n \"priority\": 8065,\n \"id\": \"32a4e6c3-63c1-3f2b-4b42-b5a9a074c38c\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n },\n {\n \"id\": \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"type\": \"catalog_rule\",\n \"attributes\": {\n \"name\": \"rule-123\",\n \"catalog_id\": \"d09b4e16-08a5-4f42-817c-6e0d98acbb63\",\n \"created_at\": \"2020-09-22T09:00:00\",\n \"updated_at\": \"2020-09-22T09:00:00\",\n \"description\": \"Catalog Rule for most favored customers\",\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n }\n ],\n \"pricebook_ids\": [\n {\n \"priority\": 3132,\n \"id\": \"ef31bc26-67a8-4764-98e2-e5f18afab45b\"\n },\n {\n \"priority\": 7986,\n \"id\": \"b2b2c713-6912-fc22-aee6-05fd1edcf18a\"\n }\n ]\n },\n \"meta\": {\n \"similarity_score\": 100,\n \"active\": false,\n \"resolved_for_shopper\": true,\n \"release_id\": \"string\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 7089\n },\n \"page\": {\n \"limit\": 7924,\n \"offset\": 2560,\n \"current\": 2046,\n \"total\": 8123\n }\n },\n \"links\": {\n \"self\": \"https://wroH.gtTY0a0ziIHMzzU,xqag6tYtdwGGFE8ZC9odsr1IjtW\",\n \"first\": \"https://HXeer.wkqQ8cg8b5m,9Heh8K.yMo6LeZ,ZD8Py.XpeA-R5TOmK.mH.FoXQVe,C+a-eP\",\n \"last\": \"https://pEyg.cutyJ8qW3\",\n \"prev\": \"http://CQBffYzBZbfGr.lluSQMlUfmiPh4.obHccNh7w2bZp7sCqbuVmPJgNdKxbGIWpVG2PW\",\n \"next\": \"https://zcynn.pljiuTS+pQQondNw0m6aWmUyS-iYOROWeKc6R\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5763ee79-6e43-44b5-80e6-bf1b495877c1", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", "rules", "validate" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"match_type\": \"resolve_for_shopper\",\n \"channels\": [\n \"string\",\n \"string\"\n ],\n \"tags\": [\n \"string\",\n \"string\"\n ],\n \"account_ids\": [\n \"string\",\n \"string\"\n ],\n \"account_tag_ids\": [\n \"string\",\n \"string\"\n ],\n \"customer_ids\": [\n \"string\",\n \"string\"\n ],\n \"pricebook_ids\": [\n \"string\",\n \"string\"\n ],\n \"schedules\": [\n {\n \"valid_from\": \"2013-10-09T06:54:57.487Z\",\n \"valid_to\": \"1969-03-10T21:22:55.175Z\"\n },\n {\n \"valid_from\": \"1971-08-04T22:42:50.913Z\",\n \"valid_to\": \"1970-02-14T04:08:40.091Z\"\n }\n ],\n \"name\": \"string\",\n \"catalog_id\": \"string\",\n \"match_date\": \"1960-01-03T09:00:06.648Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Administrator Latest Releases Catalog API", "description": "Use the Administrator Latest Releases Catalog View API to retrieve product, hierarchy and node information.\n\n:::danger\n\nThe Administrator Latest Releases Catalog View API is for Administrator use only. Do not use these endpoints on your customer-facing frontends.\n\n:::\n\nPublishing a catalog creates a release of that catalog that you can use in an organization or in a specific store or other shopper experience. You can retrieve the hierarchies, nodes, and the `live` products associated with a catalog release. You can see which parent nodes a product is associated with. This is useful if want to improve how your shoppers search your store, for example.\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n", "item": [ { "id": "035f8e17-1152-4c9c-9019-f8df1bbc5dc4", "name": "Get all Hierarchies", "request": { "name": "Get all Hierarchies", "description": { "content": "Returns the hierarchies from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` | \n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ec7a0f4f-4026-4ad2-af7b-e79ce5c0ab97", "name": "The hierarchies of a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 2450\n },\n \"page\": {\n \"limit\": 5341,\n \"offset\": 9118,\n \"current\": 4355,\n \"total\": 571\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"https://s.hpgztI7TySAo,.jtfIzxVuyMMHcXyhGQNPfjAw.JQHZMHu1KHgYb5XAAdXXOk.7uJfjqJnPCdQj9\",\n \"first\": \"https://vEcILhRdFYtOoVTfqxuqxyGGwIP.bxgsJo15VlsPR.zjqOhaRUf8,vWI,tqv,3D.2p.Rlgtn+qFNnVL\",\n \"last\": \"https://fV.emwR4hGU1p+8TR3ilf5YrMWJZzcTxuYJ,lUG8lOSJ\",\n \"prev\": \"http://ykdMJPPrssNbLbweohJLIMTmL.iztbvO5kksoINzXgCtuS.GayWvmjgudk7FDcf-\",\n \"next\": \"https://FViavDLWAF.kpDeDfzzlqJZmzmw-2DvHKS1.K.Of58Y5BBHN81GSG8rNZCRlQ9,yHubxCmeRXCh1C\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "949874c3-6c96-483f-bdd8-e17607420fd5", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2cbcdd86-becd-4c2d-aca6-caad887768b8", "name": "Get a Hierarchy", "request": { "name": "Get a Hierarchy", "description": { "content": "Returns the specified hierarchy from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a85679d2-215f-439d-826b-f2e32d657001", "name": "The catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n \"links\": {\n \"self\": \"http://XhlSxaJhlCD.gadgosPol7AOYkBb,mj915GHyoQYwV+\",\n \"first\": \"http://VwFnQmYGpfhcflflHKSRzTeiHxSXmDa.gajyPd+MXJsXXLbkEwmsDZgcYWoNUfL72efdl76B7GOKalp32UbQPCDaDrT,fNgbx50i,aMHONO\",\n \"last\": \"http://OksmWvpcnlYxwjO.yhH9GTyC5pa6MZ4ktTLkKgoB+8Hfqhppz0ppRKwl5eTpME2YjGcl\",\n \"prev\": \"http://RezTJTzXicVNsvCRpJWuqwhx.thtuQ.ZgVLAzs2s\",\n \"next\": \"https://WeDRrtWTTzvjlfVskYRKShjBPjTNfyAE.lrcNTp9ja,XyF\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ee6c516-3584-4860-ad9e-1df89a66f61f", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bf5853fb-c039-4f8f-aeca-2da27c40289d", "name": "Get a Hierarchy's Nodes", "request": { "name": "Get a Hierarchy's Nodes", "description": { "content": "Returns all nodes for the specified hierarchy from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nIn the `breadcrumbs` metadata, you can identify the parent nodes that a node is associated with. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` | \n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "85dddb9c-2a0a-4158-944a-994c91564bb1", "name": "The child nodes of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "463dd594-d711-4b8f-88af-77f52fc08984", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "711b0b4e-255a-40d8-8ae4-fe3a5e38b392", "name": "Get a Hierarchy's Children", "request": { "name": "Get a Hierarchy's Children", "description": { "content": "Returns the parent nodes for the specified hierarchy from a published catalog.\n\n![Parent Nodes](/assets/rootnodes.PNG)\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nIn the `breadcrumbs` metadata, you can identify the parent nodes that a node is associated with. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` | \n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8940752e-29ef-4941-8bff-abf836d65be4", "name": "The child nodes of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba7742bb-a58c-4588-a624-f72d3f602b80", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d9072b95-2fab-4614-9512-5808c42e526c", "name": "Get all Nodes", "request": { "name": "Get all Nodes", "description": { "content": "Returns the child nodes from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nYou can see the parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nIn a catalog, you can use a filter to return a list of nodes in a hierarchy structure that a product belongs to. You can use this to build breadcrumbs in your storefront. See [Building breadcrumbs in a storefront](#building-breadcrumbs-in-a-storefront).\n\nThe response lists the products associated with the nodes. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your hierarchies, enabling you to create unique product collections in your storefront.\n\n- If you don't provide any `curated_products`, products are listed by their `updated_at` time in descending order, with the most recently updated product first.\n- If you configure `curated_products` for only a few products, the curated products are displayed first and the other products are displayed in the order of `updated_at` time.\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- If a curated product is removed from a node, the product is also removed from the `curated_products` list.\n- A product that is curated has the `\"curated_product\": true` attribute displayed.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available.\n\n| Operator | Description | Attributes | Example |\n| --- | --- | --- | --- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug` | `filter=eq(name,some-name)` |\n| `in` | Checks if the values are included in the specified string. If they are, the condition is true.\n| `Id` | `filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ea23f855-4479-491e-83d1-4c2e5af56028", "name": "The nodes of a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8830f8eb-db51-4ecc-a0ba-90a3c1041ddd", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fad66586-2422-4513-874e-d13d298d65e8", "name": "Get a Node", "request": { "name": "Get a Node", "description": { "content": "Returns a node from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nYou can see the parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe response lists the products associated with the nodes. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your hierarchies, enabling you to create unique product collections in your storefront.\n\n- If you don't provide any `curated_products`, products are listed by their `updated_at` time in descending order, with the most recently updated product first.\n- If you configure `curated_products` for only a few products, the curated products are displayed first and the other products are displayed in the order of `updated_at` time.\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- If a curated product is removed from a node, the product is also removed from the `curated_products` list.\n- A product that is curated has the `\"curated_product\": true` attribute displayed.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7678523e-c095-40c8-aecb-f83e0ef7fd37", "name": "The catalog node.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"c8d18833-dae1-df1d-1443-509b71393918\",\n \"type\": \"product\"\n },\n {\n \"id\": \"37723df7-f022-1aa7-70ef-49332ebb687f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n \"links\": {\n \"self\": \"https://mKhiGgcHqnSzzELoJwgaXRZd.ylmWE8VKFgVh2pTO7K0.Lxf2co8W.7bLpjPeIrrZ7dL7da2aldaunmyjlZoi1\",\n \"first\": \"https://vBdTiKzlMoAWnTPRKiycdxeTr.ipdlVGgDXXGq4ggscbxfN4Uo6ay0BqNf.\",\n \"last\": \"http://E.qqHlABwNGkM\",\n \"prev\": \"http://vDzYpnynDredjrzUQoNUKOHtNPIo.kxwq6NMjP+OF+C2lvyNe3AgTtvsTFEeEj1dGtRf15AoOeiecyI8RhWTFjFX5I+svCQIcAtklmZku\",\n \"next\": \"http://VQGTDagNKodtLGFabRezrVgbgQOOrSnJr.itx+RM3,E1d4s\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "985aa0a2-1dd6-4369-aab9-b3c6f311efde", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a39b6528-8529-49a7-af36-0a823127d722", "name": "Get a Node's Children", "request": { "name": "Get a Node's Children", "description": { "content": "Returns the child nodes for a node from a published catalog.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nYou can see the parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nIn a catalog, you can use a filter to return a list of nodes in a hierarchy structure that a product belongs to. You can use this to build breadcrumbs in your storefront. For more information, see [Building breadcrumbs in a storefront](#building-breadcrumbs-in-a-storefront).\n\nThe response lists the products associated with the nodes. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your hierarchies, enabling you to create unique product collections in your storefront.\n\n- If you don't provide any `curated_products`, products are listed by their `updated_at` time in descending order, with the most recently updated product first.\n- If you configure `curated_products` for only a few products, the curated products are displayed first and the other products are displayed in the order of `updated_at` time.\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- If a curated product is removed from a node, the product is also removed from the `curated_products` list.\n- A product that is curated has the `\"curated_product\": true` attribute displayed.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available.\n\n| Operator | Description | Attributes | Example |\n| --- | --- | --- | --- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug` | `filter=eq(name,some-name)` |\n| `in` | Checks if the values are included in the specified string. If they are, the condition is true.\n| `Id` | `filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "964e30f4-e035-4754-81be-ca530d0992ed", "name": "The child nodes of a catalog node.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad69a9b1-b873-4689-ada6-19ece67eccd8", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5605a994-c2f7-4295-8e3c-86102c52b0e4", "name": "Get all Products", "request": { "name": "Get all Products", "description": { "content": "Returns the products from a published catalog. Only the products in a `live` status are retrieved. Currently, published catalogs are limited to the current release and two releases prior to the current release.\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe `variations` object lists the variation IDs and variation option IDs and their corresponding product IDs that are generated when the variation and variation options are built with a product. The `variations` object can then be added to your catalogs. By default, variations and variation options are sorted randomly. You can use the `sort_order` attribute to sort the order of your variation and variation options in `variations`. Once a parent product is published in a catalog, the [Get a List of products in a catalog release](/docs/api/pxm/catalog/get-all-products) response displays the sorted variations and variation options. Variations and variation options are displayed in descending order according to their `sort_order` values.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. \n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types`, you can specify more than one product type. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "721e3ba6-c14e-4331-80cc-16e637040e58", "name": "The products of a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9863ebb-4830-4ef0-91ae-1fbd6f3f43ad", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3f755f64-a0d3-44cc-b5cd-89d5100e2e84", "name": "Get a Product", "request": { "name": "Get a Product", "description": { "content": "Returns a product from a published catalog. The product must be in `live` status. Currently, published catalogs are limited to the current release and two releases prior to the current release.\n\n### Product and Node Associations in Breadcrumb Metadata\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Product Variations\n\nThe `variations` object lists the variation IDs and variation option IDs and their corresponding product IDs that are generated when the variation and variation options are built with a product. The `variations` object can then be added to your catalogs. By default, variations and variation options are sorted randomly. You can use the `sort_order`attribute to sort the order of your variation and variation options in `variations`. Once a parent product is published in a catalog, the get a product in a catalog release response displays the sorted variations and variation options. Variations and variation options are displayed in descending order according to their `sort_order` values.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. \n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4d969bb2-4b34-4fc3-8db0-716208f6a810", "name": "The product of a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8086,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 3771,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 8040,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 2541,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6572,\n \"max\": 3893,\n \"sort_order\": 6714,\n \"options\": [\n {\n \"id\": \"3ea5a067-7935-6059-136c-be32c630257f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1410,\n \"max\": 1717,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_2\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_3\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n },\n \"key_2\": {\n \"key_0\": {},\n \"key_1\": {}\n },\n \"key_3\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"55d761a8-ea5a-3a55-f15a-68b05687c3aa\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"c98dff34-e9ab-7cee-d2e6-18a7e7d26805\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"6063f886-3259-4c75-bbaf-a7cae02e5c34\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"adbf4783-de61-632a-f12d-eb179358df3a\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"fd7d3fba-773a-e772-af12-8ba6c34f9504\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"ddae7cf3-a34b-7b35-97e5-24f7139843e2\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3235,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3366,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1168,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6896,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4624,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1951,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7376,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4893,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3899,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3062,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9144,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2255,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 754,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4212,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9828,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2037,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4251,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2536,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4524,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_3\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3932,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7084,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 287,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7136,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4017,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8315,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9892,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5819,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3574,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4327,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4464,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3694,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2083,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2589,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1521,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2405,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6213,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1071,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4986,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8005,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6762,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"9f303b4d-5cfc-37ba-96cf-34452a9a1ae7\",\n \"name\": \"string\",\n \"sort_order\": 9647,\n \"option\": {\n \"id\": \"8323c02b-902a-ba60-0703-81858f7d3b95\",\n \"name\": \"string\",\n \"sort_order\": 3652,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"e4176512-f735-cda5-3d05-74fcfc52a96d\",\n \"name\": \"string\",\n \"sort_order\": 5471,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"79d9f2e7-80d9-dd31-514a-542761f9dd61\",\n \"name\": \"string\",\n \"sort_order\": 275,\n \"option\": {\n \"id\": \"59ff712d-8976-a1e0-26fe-4115ac4768b8\",\n \"name\": \"string\",\n \"sort_order\": 1297,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"df480b71-cb3e-e243-dc34-8e758841bee1\",\n \"name\": \"string\",\n \"sort_order\": 9717,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7985,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 4369,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 3384,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 4664,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 9009,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6712,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7364,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9408,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8731,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5618,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5901,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3853,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5973,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3842,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1526,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7674,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n },\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"231234ae-c8a2-a97b-12d3-f70a596cbb3b\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5194,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2897,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6811,\n \"max\": 2257,\n \"sort_order\": 5526,\n \"options\": [\n {\n \"id\": \"bd1462dc-c781-39c3-faee-b31ef2d5111f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 2268,\n \"max\": 4050,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"min\": 6606,\n \"max\": 8178,\n \"sort_order\": 1361,\n \"options\": [\n {\n \"id\": \"1ea01de2-85ac-c07c-40e5-6a9d901c6b39\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 6130,\n \"max\": 6754,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"aa25553a-1d5d-0328-2e73-0811bf2da5f7\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"3964868e-19e4-99c6-9354-996042d2769e\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"44795b12-056a-af98-7ce0-1e7573b14460\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"a4970b1e-3929-871d-f398-852fd883c4ac\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c6668deb-a1fc-04ce-adeb-fdec06b03754\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"259d9dbd-023d-b58a-3794-d9af0b698123\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8565,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 117,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9699,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7841,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3501,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1281,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1482,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4305,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9865,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3936,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8982,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6785,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8345,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6123,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8207,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6358,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7490,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6076,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6949,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5425,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7829,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2344,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4605,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2929,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 788,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9934,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9522,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6658,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6499,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9260,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_2\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2769,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6245,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7104,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7295,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2131,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5166,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8164,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 681,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4274,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 523,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_3\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5283,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8525,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7866,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7538,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5861,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7820,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6438,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5159,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7962,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2390,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8286,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 422,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8550,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1120,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7579,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n },\n \"key_2\": {\n \"value\": \"\"\n },\n \"key_3\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 955,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4664,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3386,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"19ecf97f-58f7-d19f-d60b-ea2243454f1e\",\n \"name\": \"string\",\n \"sort_order\": 41,\n \"option\": {\n \"id\": \"35189601-378a-56dc-9ad0-20d39bff3cd8\",\n \"name\": \"string\",\n \"sort_order\": 826,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"0598449a-8f36-3769-a025-af3f4c314316\",\n \"name\": \"string\",\n \"sort_order\": 3468,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"02506a63-78a5-f2e4-97a0-fac868211709\",\n \"name\": \"string\",\n \"sort_order\": 4478,\n \"option\": {\n \"id\": \"96ef6a16-e30b-719d-e928-1f4ec9295b6f\",\n \"name\": \"string\",\n \"sort_order\": 1917,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"8d7c07f0-41be-3d78-dc71-eb30b12a0ef7\",\n \"name\": \"string\",\n \"sort_order\": 9233,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 768,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3306,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5723,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1746,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1604,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1529,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9247,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3661,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"74ddf67f-a343-7fd3-02ca-f268c360c059\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://GIYpLJerwwqvVqnQoSMBbhucryrau.azN,evXBHWPsqmKtKRgWBb6jLOFCks\",\n \"first\": \"http://TyLwhmfNPhtCSnJUmLNVceDeeZmXvoCPd.koldAMzgQU3LKJFpDxBuFGnswkMO.CzJ8Oe100LGdC\",\n \"last\": \"https://XnLoZTdueTG.ypx,Re1u\",\n \"prev\": \"http://mjHGDnmtifAdCVJApwuQe.jqoO7662XJNpdOevmJdXeZu2Pjn7P\",\n \"next\": \"https://rNuAsBrWiTcElHgbwhMHsDwh.lfuvHbbxqVrTjRLkvOLuSrYBxLmD0BEooezXeaPlpL5JDYcH+p1Z+xZNw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c2e14ed-fb2e-4ed6-8553-999efe426f7c", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a7501529-f10e-4890-bbfd-f2c7c9dca7d5", "name": "Get all Related Products of a Product", "request": { "name": "Get all Related Products of a Product", "description": { "content": "Returns related products of the provided product ID from a published catalog.\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "custom_relationship_slug", "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7cf950ab-6658-49a9-b59d-0c62c2324be6", "name": "The related products of a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" }, { "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "string", "key": "custom_relationship_slug" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7db8a27-5a66-4522-a810-fcb867a317c2", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" }, { "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "string", "key": "custom_relationship_slug" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c567431b-5282-4999-afd2-e77c1dc47d2e", "name": "Get a Bundle's Component Products", "request": { "name": "Get a Bundle's Component Products", "description": { "content": "With Product Experience Manager, you can [create](/docs/api/pxm/products/create-product) and manage bundles. A bundle is a purchasable product, comprising of one or more products that you want to sell together. \n\nYou can create multiple components within a bundle. Each component must have at least one or more options. Each option is a product and a quantity.\n\nThis endpoint returns a list of component product IDs for the specified bundle.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "852c58c7-0b73-4371-82c7-71b417d69bbf", "name": "The list of component product IDs of a specific bundle product from a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 6649\n },\n \"page\": {\n \"limit\": 4021,\n \"offset\": 9698,\n \"current\": 3956,\n \"total\": 4162\n }\n },\n \"data\": [\n {\n \"id\": \"e8349de5-f144-6947-0154-d11ec17f2d55\",\n \"type\": \"product\"\n },\n {\n \"id\": \"06ce32ca-7611-7c1d-601d-8975e527e14b\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"http://GczDIEvviXRDkdqsCdfEpldcKx.mbmKzo6LFiJUSRpY\",\n \"first\": \"https://qqFVZNqaGyHLTJWJXJtjQktruY.jlsaVc1JdhHmE\",\n \"last\": \"https://WUjNBqBCNjIicxYZvgjd.xrvft0QK4,Z5qLo7GnClF3,7-EeQHKvo\",\n \"prev\": \"https://TVOesZT.omZ-vwF1jyK4oST-moACzHZ,1iq9R,1qX,34HREUXfqNi\",\n \"next\": \"https://sGbBFgNvhlSHRgPCoy.kundGTWrtULJvyYCrxPwwjpGIyR1Gf0+YM6uZi3XHrN+YGtRAk20KZdODSZ6DOVv4ppC6ab6C4gTCSr\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff5d40e1-b6cc-4689-b0d0-9ee1886cfd61", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1f872ec0-4abc-46cb-ac41-79edc48d1efe", "name": "Get a Parent Product's Child Products", "request": { "name": "Get a Parent Product's Child Products", "description": { "content": "For a specified product and catalog release, retrieves a list of child products from a parent product. Any product other than a base product results in a `422 Unprocessable Entity` response. Only the products in a `live` status are retrieved.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. If no catalog rules are configured, the first catalog found is returned. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated within the breadcrumbs metadata for each product. For example, this is useful if you want to improve how your shoppers search your store. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types`, you can specify more than one product type. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "320198a9-1a4e-4824-9efd-bdc2df832a54", "name": "The list of child products of a specific base product from a catalog.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0205310f-d5c5-4c70-bec5-5c9c3fbfe89a", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6f26f9b7-c5a5-4a60-987a-25b1bdff2b02", "name": "Get a Hierarchy's Products", "request": { "name": "Get a Hierarchy's Products", "description": { "content": "Returns the products associated with the specified hierarchy in the catalog. The products must be in the `live` status.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. See [Resolving catalog rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe `variations` object lists the variation IDs and variation option IDs and their corresponding product IDs that are generated when the variation and variation options are built with a product. The variations object can then be added to your catalogs. By default, variations and variation options are sorted randomly. You can use the `sort_order` attribute to sort the order of your variation and variation options in variations. Once a parent product is published in a catalog, the [Get a List of products in a catalog](/docs/api/pxm/catalog/get-all-products) release response displays the sorted variations and variation options. Variations and variation options are displayed in descending order according to their `sort_order` values.\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types`, you can specify more than one product type. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "16e018ab-09f0-4c13-bad7-842c26042829", "name": "The products of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "828684c9-4457-418c-993c-a663300d9174", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "02671730-8417-46d1-b6dc-12ccd6895f37", "name": "Get a Node's Products", "request": { "name": "Get a Node's Products", "description": { "content": "Returns the products associated with the specified hierarchy node in the catalog. The products must be in the `live` status. If the products have been curated, then the products are returned in the order specified in the `curated_products` attribute. A product that is curated has the `\"curated_product\": true` attribute displayed.\n\n:::note\n\nCurrently, published catalogs are limited to the current release and two releases prior to the current release.\n\n:::\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. See [Resolving catalog rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe `variations` object lists the variation IDs and variation option IDs and their corresponding product IDs that are generated when the variation and variation options are built with a product. The `variations` object can then be added to your catalogs. By default, variations and variation options are sorted randomly. You can use the `sort_order` attribute to sort the order of your variation and variation options in `variations`. Once a parent product is published in a catalog, the [Get a List of products in a catalog release](/docs/api/pxm/catalog/get-all-products) response displays the sorted variations and variation options. Variations and variation options are displayed in descending order according to their `sort_order` values.\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types` and `tags`, you can only specify one. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types` and `tags`, you can specify more than one. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1e7cfa92-4c06-49bf-9fd0-2d5607e3d8d1", "name": "The products of a catalog node.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6866e4c7-7849-437f-a8d4-fdbbcacce12f", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalogs", ":catalog_id", "releases", ":release_id", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a published release of the catalog or `latestPublished` for the most recently published version.", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" }, { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Shopper Catalog API", "description": "Use the Shopper Catalog View API to retrieve hierarchy, node and product information for a catalog release. When you publish a catalog for a store, you can define catalog rules so that you can show catalogs with different pricing or different products to preferred customers or channels. These endpoints can be used in your customer-facing frontends.\n\nA catalog is a combination of one or more hierarchies, products, and a price book. Use the Products API and Hierarchies API to create a hierarchy of products that can be included in a catalog. Use the Price Book API to associate prices with products.\n\n### Characteristics of Shopper Catalogs\n\nShopper catalogs can have the following characteristics.\n\n- Use catalog rules to schedule a catalog to appear during a particular date and time, such as a seasonal catalog. The catalog may have different pricing than the other catalogs. You can have multiple published catalogs.\n- If you have defined catalog rules and you want to retrieve a published catalog for a particular channel or a user-defined tag, you must set the appropriate headers in the request:\n - `EP-Channel` - The channel, such as website or mobile app. See [**Create a Catalog Rule**](/docs/api/pxm/catalog/create-rule).\n - `EP-Context-Tag` - A tag defined in the store, such as `clearance`. See [**Create a Catalog Rule**](/docs/api/pxm/catalog/create-rule).\n* When a catalog is ready to be used in a store, you publish it. See [**Publish a Catalog**](/docs/api/pxm/catalog/publish-release).\n* You can create and publish catalogs for different contexts and channels. You can see the differences between the last 2 consecutive catalog releases. See [**Publish a Catalog**](/docs/api/pxm/catalog/publish-release).\n* You retrieve catalogs for your shopper experience by using the Shopper Catalog View API. For more information on how you can retrieve a catalog as a shopper using the Catalog API.\n* When a catalog is published for a store, the corresponding events contain `store_id` and `org_id`. \n* When a catalog is published for an organization, the corresponding events contain `org_id`. \n* Use the `sort_order` value in `variations` to program your storefront to display the variation options in the order that you want.\n\n### Shopper Catalog Caching\n\nWhen conducting a `GET` on `catalog` endpoints, all data returned, including catalog releases, products, nodes and hierarchies, are cached for 5 minutes. This means, if you call the same endpoint again, the catalog data is retrieved from the cached objects pool, optimizing the performance and efficiency of your store front.\n\nIf you use any of the `catalog` endpoints with a `filter` or `include` query parameter, these are cached separately. \n\nThe cached entries disappear from the cached objects pool after 5 minutes.\n", "item": [ { "id": "2791b5bf-d90b-4fd7-963e-059c4e9586d2", "name": "Get all Hierarchies", "request": { "name": "Get all Hierarchies", "description": { "content": "Returns all hierarchies from a catalog.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6db741d1-9d7b-4b72-bf43-e5206e3a4b98", "name": "The hierarchies of the catalog.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 2450\n },\n \"page\": {\n \"limit\": 5341,\n \"offset\": 9118,\n \"current\": 4355,\n \"total\": 571\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"https://s.hpgztI7TySAo,.jtfIzxVuyMMHcXyhGQNPfjAw.JQHZMHu1KHgYb5XAAdXXOk.7uJfjqJnPCdQj9\",\n \"first\": \"https://vEcILhRdFYtOoVTfqxuqxyGGwIP.bxgsJo15VlsPR.zjqOhaRUf8,vWI,tqv,3D.2p.Rlgtn+qFNnVL\",\n \"last\": \"https://fV.emwR4hGU1p+8TR3ilf5YrMWJZzcTxuYJ,lUG8lOSJ\",\n \"prev\": \"http://ykdMJPPrssNbLbweohJLIMTmL.iztbvO5kksoINzXgCtuS.GayWvmjgudk7FDcf-\",\n \"next\": \"https://FViavDLWAF.kpDeDfzzlqJZmzmw-2DvHKS1.K.Of58Y5BBHN81GSG8rNZCRlQ9,yHubxCmeRXCh1C\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "556eaca5-e15d-435a-ba87-4386fa3db03b", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nThis endpoints supports filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "38db89c0-35e0-4b23-bed0-03c10ac7f730", "name": "Get a Hierarchy", "request": { "name": "Get a Hierarchy", "description": { "content": "Returns a hierarchy from the catalog.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog to retrieve. For information about how catalog rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5cda1b76-bbd1-4ddf-842d-67529a42efad", "name": "The catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"nodes\": {\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"hierarchy\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n \"links\": {\n \"self\": \"http://XhlSxaJhlCD.gadgosPol7AOYkBb,mj915GHyoQYwV+\",\n \"first\": \"http://VwFnQmYGpfhcflflHKSRzTeiHxSXmDa.gajyPd+MXJsXXLbkEwmsDZgcYWoNUfL72efdl76B7GOKalp32UbQPCDaDrT,fNgbx50i,aMHONO\",\n \"last\": \"http://OksmWvpcnlYxwjO.yhH9GTyC5pa6MZ4ktTLkKgoB+8Hfqhppz0ppRKwl5eTpME2YjGcl\",\n \"prev\": \"http://RezTJTzXicVNsvCRpJWuqwhx.thtuQ.ZgVLAzs2s\",\n \"next\": \"https://WeDRrtWTTzvjlfVskYRKShjBPjTNfyAE.lrcNTp9ja,XyF\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d23e53f-39c5-46ce-9ee4-3af51f40294c", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "02d570e9-bc07-4db9-b5c0-bd311028c358", "name": "Get a Hierarchy's Nodes", "request": { "name": "Get a Hierarchy's Nodes", "description": { "content": "Returns all the nodes for the specified hierarchy.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nIn the `breadcrumbs` metadata, you can identify the parent nodes that a node is associated with. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9d665b26-180a-4664-a716-dfa4a87f73e6", "name": "The child nodes of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c74d6394-ea55-4d04-9d10-1aba861d127c", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d1bb4b46-8151-444b-8c0b-856e4c2b5bd6", "name": "Get a Hierarchy's Children", "request": { "name": "Get a Hierarchy's Children", "description": { "content": "Returns the parent nodes for the specified hierarchy.\n\n![Parent Nodes](/assets/rootnodes.PNG)\n\nIf you have multiple catalog rules defined, the rule that best matches the shopperʼs context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nIn the `breadcrumbs` metadata, you can identify the parent nodes that a node is associated with. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThe following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:--- |:--- |:--- |:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug`| `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. | `id` | `filter=in(id,some-id)` |\n\nFor more information, see [Filtering](/guides/Getting-Started/filtering).\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "796772a8-dd68-49a6-8c69-bd168ac9a37b", "name": "The child nodes of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8862dae-46dc-4ac4-8d35-dcf6adcb8639", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "34e323bc-7324-4058-8350-93bd4bd94cee", "name": "Get all Nodes", "request": { "name": "Get all Nodes", "description": { "content": "Returns all nodes in the catalog.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nIn a catalog, you can use a filter to return a list of nodes in a hierarchy structure that a product belongs to. You can use this to build breadcrumbs in your storefront. For more information, see [Building breadcrumbs in a storefront](#building-breadcrumbs-in-a-storefront).\n\nThe response lists the products associated with the nodes. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your hierarchies, enabling you to create unique product collections in your storefront.\n\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- If a curated product is removed from a node, the product is also removed from the `curated_products` list.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available.\n\n| Operator | Description | Attributes | Example |\n| --- | --- | --- | --- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug` | `filter=eq(name,some-name)` |\n| `in` | Checks if the values are included in the specified string. If they are, the condition is true.\n| `Id` | `filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "854b5594-2b28-4f85-9965-b8a49502a0f5", "name": "The nodes of the catalog.", "originalRequest": { "url": { "path": [ "catalog", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f7df41c-40a0-4ea1-8cb1-b417a8ce0ef0", "name": "An unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ca9e5215-c6dc-4dad-a3b9-e5d3c6f04684", "name": "Get a Node", "request": { "name": "Get a Node", "description": { "content": "Returns a node from the catalog.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe response lists the products associated with a node. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your nodes, enabling you to create unique product collections in your storefront.\n\n- If you don't provide any `curated_products`, products are listed by their `updated_at` time in descending order, with the most recently updated product first.\n- If you configure `curated_products` for only a few products, the curated products are displayed first and the other products are displayed in the order of `updated_at` time.\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- A product that is curated has the `\"curated_product\": true` attribute displayed.\n- If a curated product is removed from a node, the product is also removed from the `curated_products` list.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a5e2960d-b56a-44f8-8985-71d55f38e28c", "name": "The catalog node.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"c8d18833-dae1-df1d-1443-509b71393918\",\n \"type\": \"product\"\n },\n {\n \"id\": \"37723df7-f022-1aa7-70ef-49332ebb687f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n \"links\": {\n \"self\": \"https://mKhiGgcHqnSzzELoJwgaXRZd.ylmWE8VKFgVh2pTO7K0.Lxf2co8W.7bLpjPeIrrZ7dL7da2aldaunmyjlZoi1\",\n \"first\": \"https://vBdTiKzlMoAWnTPRKiycdxeTr.ipdlVGgDXXGq4ggscbxfN4Uo6ay0BqNf.\",\n \"last\": \"http://E.qqHlABwNGkM\",\n \"prev\": \"http://vDzYpnynDredjrzUQoNUKOHtNPIo.kxwq6NMjP+OF+C2lvyNe3AgTtvsTFEeEj1dGtRf15AoOeiecyI8RhWTFjFX5I+svCQIcAtklmZku\",\n \"next\": \"http://VQGTDagNKodtLGFabRezrVgbgQOOrSnJr.itx+RM3,E1d4s\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2116c892-ed36-4ab9-b653-bb7aa5401b7a", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6fb02e0e-b497-4b01-89f8-2fb757312a51", "name": "Get a Node's Children", "request": { "name": "Get a Node's Children", "description": { "content": "Returns the child nodes for a node in the catalog.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see which parent nodes a node is associated with in the `breadcrumbs` metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nThe response lists the products associated with the nodes. If products are [curated](/guides/How-To/Products/curating-products), they are displayed in `curated_products`. Product curation allows you to promote specific products within each of your hierarchies, enabling you to create unique product collections in your storefront.\n\n- If you don't provide any curated_products, products are listed by their updated_at time in descending order, with the most recently updated product first.\n- If you configure curated_products for only a few products, the curated products are displayed first and the other products are displayed in the order of updated_at time.\n- You can only curate 20 products or less. You cannot have more than 20 curated products.\n- A product that is curated has the \"curated_product\": true attribute displayed.\n- If a curated product is removed from a node, the product is also removed from the curated_products list.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available.\n\n| Operator | Description | Attributes | Example |\n| --- | --- | --- | --- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. | `name`, `slug` | `filter=eq(name,some-name)` |\n| `in` | Checks if the values are included in the specified string. If they are, the condition is true.\n| `Id` | `filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "229e11c2-d665-4087-9a15-ed79f158f596", "name": "The child nodes of a catalog node.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 9100\n },\n \"page\": {\n \"limit\": 5263,\n \"offset\": 4371,\n \"current\": 729,\n \"total\": 9551\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"84ea49c0-4a9f-820e-69f0-f69caaed4699\",\n \"type\": \"product\"\n },\n {\n \"id\": \"bf83228b-db5b-1d46-677d-7c6ac59d617f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n },\n {\n \"attributes\": {\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"Formal dresswear\",\n \"label\": \"category\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\",\n \"curated_products\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"status\": \"live\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"updated_at\": \"1970-01-01T00:00:00.000\"\n },\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"relationships\": {\n \"products\": {\n \"data\": [\n {\n \"id\": \"971f082f-21ba-1901-8876-e004fd1a946e\",\n \"type\": \"product\"\n },\n {\n \"id\": \"ceac8214-a7cf-4182-cea9-c63ac6dc6758\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"children\": {\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"parent\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"node\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n },\n \"hierarchy\": {\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"hierarchy\"\n },\n \"links\": {\n \"related\": \"string\"\n }\n }\n },\n \"type\": \"node\",\n \"meta\": {\n \"language\": \"en-GB\",\n \"bread_crumb\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\",\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"breadcrumbs\": [\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n },\n {\n \"id\": \"e871df93-c769-49a9-9394-a6fd555b8e8a\",\n \"name\": \"Formal dresswear\",\n \"slug\": \"formal\"\n }\n ],\n \"has_children\": true\n }\n }\n ],\n \"links\": {\n \"self\": \"http://wzWwpnqwKnAQHNxEIXVZtDEVeKQ.ofjUMcGlmkn7dljgtmLZC-q3fDAyiOj3HLrngGu+5oWvUIit3gqht\",\n \"first\": \"http://GpcUUkeQkWynCCZNLafSuAhNFgm.umE2wqO,Msx6DR+IdG2jUqLbOJLzCWHOg0+dMljtLlpFTik\",\n \"last\": \"http://NHjlDCmMSJ.nkaDrGm,z,WYRKF4l+4TJrKbptjuoDP\",\n \"prev\": \"https://JGgOekUxglGOPdAAJNAIxEtgfTikWAH.krdiDyhBdUqqiom9CAJNengwnLTxyF-dSJiiCyoljjkTOloZo,BB7T3nHI20zJp\",\n \"next\": \"https://nvlkWpUcAww.tzYDkSfsMozMbcwiECQYKJHe-R0hwhdoJvd0FKkUQVxrN-0lz7zbI\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "574ffc88-ab1f-4f9a-8d22-fd4c24ad1336", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering, see [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ec936352-7f07-422b-abac-81199b6b7900", "name": "Get all Products", "request": { "name": "Get all Products", "description": { "content": "Retrieves the list of products from the catalog. Only the products in a live status are retrieved.\n\n### Catalog Rules\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. If no catalog rules are configured, the first catalog found is returned. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\n### Product and Node Associations\n\n You can see the parent nodes a product is associated within the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. For example, this is useful if you want to improve how your shoppers search your store. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types` and `tags`, you can only specify one. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types` and `tags`, you can specify more than one. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "45ceee8b-73b0-43d5-a431-5657cd891d45", "name": "The products of a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ddd8543-b573-4338-89ca-e7e84e017866", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f5129d8b-b72c-4b75-839c-37556163d732", "name": "Get a Product", "request": { "name": "Get a Product", "description": { "content": "Returns the specified product from the catalog. The product must be in the `live` status.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6f08c330-870c-42e2-b375-e6db0b9d5f18", "name": "The product of a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8086,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 3771,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 8040,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 2541,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6572,\n \"max\": 3893,\n \"sort_order\": 6714,\n \"options\": [\n {\n \"id\": \"3ea5a067-7935-6059-136c-be32c630257f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1410,\n \"max\": 1717,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_2\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_3\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n },\n \"key_2\": {\n \"key_0\": {},\n \"key_1\": {}\n },\n \"key_3\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"55d761a8-ea5a-3a55-f15a-68b05687c3aa\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"c98dff34-e9ab-7cee-d2e6-18a7e7d26805\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"6063f886-3259-4c75-bbaf-a7cae02e5c34\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"adbf4783-de61-632a-f12d-eb179358df3a\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"fd7d3fba-773a-e772-af12-8ba6c34f9504\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"ddae7cf3-a34b-7b35-97e5-24f7139843e2\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3235,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3366,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1168,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6896,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4624,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1951,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7376,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4893,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3899,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3062,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9144,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2255,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 754,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4212,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9828,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2037,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4251,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2536,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4524,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_3\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3932,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7084,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 287,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7136,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4017,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8315,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9892,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5819,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3574,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4327,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4464,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3694,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2083,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2589,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1521,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2405,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6213,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1071,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4986,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8005,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6762,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"9f303b4d-5cfc-37ba-96cf-34452a9a1ae7\",\n \"name\": \"string\",\n \"sort_order\": 9647,\n \"option\": {\n \"id\": \"8323c02b-902a-ba60-0703-81858f7d3b95\",\n \"name\": \"string\",\n \"sort_order\": 3652,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"e4176512-f735-cda5-3d05-74fcfc52a96d\",\n \"name\": \"string\",\n \"sort_order\": 5471,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"79d9f2e7-80d9-dd31-514a-542761f9dd61\",\n \"name\": \"string\",\n \"sort_order\": 275,\n \"option\": {\n \"id\": \"59ff712d-8976-a1e0-26fe-4115ac4768b8\",\n \"name\": \"string\",\n \"sort_order\": 1297,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"df480b71-cb3e-e243-dc34-8e758841bee1\",\n \"name\": \"string\",\n \"sort_order\": 9717,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7985,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 4369,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 3384,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 4664,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 9009,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6712,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7364,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9408,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8731,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5618,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5901,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3853,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5973,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3842,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1526,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7674,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n },\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"231234ae-c8a2-a97b-12d3-f70a596cbb3b\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5194,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2897,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6811,\n \"max\": 2257,\n \"sort_order\": 5526,\n \"options\": [\n {\n \"id\": \"bd1462dc-c781-39c3-faee-b31ef2d5111f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 2268,\n \"max\": 4050,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"min\": 6606,\n \"max\": 8178,\n \"sort_order\": 1361,\n \"options\": [\n {\n \"id\": \"1ea01de2-85ac-c07c-40e5-6a9d901c6b39\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 6130,\n \"max\": 6754,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"aa25553a-1d5d-0328-2e73-0811bf2da5f7\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"3964868e-19e4-99c6-9354-996042d2769e\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"44795b12-056a-af98-7ce0-1e7573b14460\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"a4970b1e-3929-871d-f398-852fd883c4ac\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c6668deb-a1fc-04ce-adeb-fdec06b03754\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"259d9dbd-023d-b58a-3794-d9af0b698123\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8565,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 117,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9699,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7841,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3501,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1281,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1482,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4305,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9865,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3936,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8982,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6785,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8345,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6123,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8207,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6358,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7490,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6076,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6949,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5425,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7829,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2344,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4605,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2929,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 788,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9934,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9522,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6658,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6499,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9260,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_2\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2769,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6245,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7104,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7295,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2131,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5166,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8164,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 681,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4274,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 523,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_3\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5283,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8525,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7866,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7538,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5861,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7820,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6438,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5159,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7962,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2390,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8286,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 422,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8550,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1120,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7579,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n },\n \"key_2\": {\n \"value\": \"\"\n },\n \"key_3\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 955,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4664,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3386,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"19ecf97f-58f7-d19f-d60b-ea2243454f1e\",\n \"name\": \"string\",\n \"sort_order\": 41,\n \"option\": {\n \"id\": \"35189601-378a-56dc-9ad0-20d39bff3cd8\",\n \"name\": \"string\",\n \"sort_order\": 826,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"0598449a-8f36-3769-a025-af3f4c314316\",\n \"name\": \"string\",\n \"sort_order\": 3468,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"02506a63-78a5-f2e4-97a0-fac868211709\",\n \"name\": \"string\",\n \"sort_order\": 4478,\n \"option\": {\n \"id\": \"96ef6a16-e30b-719d-e928-1f4ec9295b6f\",\n \"name\": \"string\",\n \"sort_order\": 1917,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"8d7c07f0-41be-3d78-dc71-eb30b12a0ef7\",\n \"name\": \"string\",\n \"sort_order\": 9233,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 768,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3306,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5723,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1746,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1604,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1529,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9247,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3661,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"74ddf67f-a343-7fd3-02ca-f268c360c059\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://GIYpLJerwwqvVqnQoSMBbhucryrau.azN,evXBHWPsqmKtKRgWBb6jLOFCks\",\n \"first\": \"http://TyLwhmfNPhtCSnJUmLNVceDeeZmXvoCPd.koldAMzgQU3LKJFpDxBuFGnswkMO.CzJ8Oe100LGdC\",\n \"last\": \"https://XnLoZTdueTG.ypx,Re1u\",\n \"prev\": \"http://mjHGDnmtifAdCVJApwuQe.jqoO7662XJNpdOevmJdXeZu2Pjn7P\",\n \"next\": \"https://rNuAsBrWiTcElHgbwhMHsDwh.lfuvHbbxqVrTjRLkvOLuSrYBxLmD0BEooezXeaPlpL5JDYcH+p1Z+xZNw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d54d137-c5f8-40bb-b7e8-88e71e26a241", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "11b975cc-3c77-41ad-934d-53bb51f6b1e6", "name": "Get all Related Products of a Product", "request": { "name": "Get all Related Products of a Product", "description": { "content": "Returns related products of the provided product ID from a catalog.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "custom_relationship_slug", "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "be77481d-71cc-4167-85e6-78f5dba07a05", "name": "The related products of a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" }, { "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "string", "key": "custom_relationship_slug" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4cbe467a-d5cd-4d0b-8b7a-7d9d09b95d15", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", ":custom_relationship_slug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" }, { "disabled": false, "description": { "content": "(Required) The custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "string", "key": "custom_relationship_slug" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d1468657-a8a4-4da5-9b66-d4c4913e204b", "name": "Get a Bundle's Component Products", "request": { "name": "Get a Bundle's Component Products", "description": { "content": "With Product Experience Manager, you can [create](/docs/api/pxm/products/create-product) and manage bundles. A bundle is a purchasable product, comprising of one or more products that you want to sell together. \n\nYou can create multiple components within a bundle. Each component must have at least one or more options. Each option is a product and a quantity.\n\nThis endpoint returns a list of component product IDs for the specified bundle.\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c853e5b2-b6ed-455e-9bb8-28e2262cb835", "name": "The list of component product IDs of a bundle product from a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 6649\n },\n \"page\": {\n \"limit\": 4021,\n \"offset\": 9698,\n \"current\": 3956,\n \"total\": 4162\n }\n },\n \"data\": [\n {\n \"id\": \"e8349de5-f144-6947-0154-d11ec17f2d55\",\n \"type\": \"product\"\n },\n {\n \"id\": \"06ce32ca-7611-7c1d-601d-8975e527e14b\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"http://GczDIEvviXRDkdqsCdfEpldcKx.mbmKzo6LFiJUSRpY\",\n \"first\": \"https://qqFVZNqaGyHLTJWJXJtjQktruY.jlsaVc1JdhHmE\",\n \"last\": \"https://WUjNBqBCNjIicxYZvgjd.xrvft0QK4,Z5qLo7GnClF3,7-EeQHKvo\",\n \"prev\": \"https://TVOesZT.omZ-vwF1jyK4oST-moACzHZ,1iq9R,1qX,34HREUXfqNi\",\n \"next\": \"https://sGbBFgNvhlSHRgPCoy.kundGTWrtULJvyYCrxPwwjpGIyR1Gf0+YM6uZi3XHrN+YGtRAk20KZdODSZ6DOVv4ppC6ab6C4gTCSr\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eaed3bc3-73c9-4f65-93f6-82b8b4c9eb4f", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c1aebfc5-e229-4c64-8685-d2d5e21622e7", "name": "Get a Parent Product's Child Products", "request": { "name": "Get a Parent Product's Child Products", "description": { "content": "For a specified product and catalog release, retrieves a list of child products from a parent product. Any product other than a base product results in a `422 Unprocessable Entity` response. Only the products in a `live` status are retrieved.\n\nIf you have multiple catalog rules defined, the rule that best matches the shopperʼs context is used to determine which catalog is retrieved. If no catalog rules are configured, the first catalog found is returned. For information about how rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated within the `breadcrumbs` metadata for each product. For example, this is useful if you want to improve how your shoppers search your store. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types` and `tags`, you can only specify one. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types` and `tags`, you can specify more than one. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ef8df490-07cd-46e0-be8c-f452443555cf", "name": "The list of child products of a parent product from a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a89015e2-a2ec-4104-8bc2-d7f6c0de8650", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fff77210-cbeb-40b5-a146-667e00ccebe0", "name": "Get a Hierarchy's Products", "request": { "name": "Get a Hierarchy's Products", "description": { "content": "Returns the products associated with the specified hierarchy in the catalog. The products must be in the live status.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. See [Resolving catalog rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types` and `tags`, you can only specify one. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types` and `tags`, you can specify more than one. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "hierarchy_id", "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "45e2bb9b-4b3e-4185-aa5d-c227f30ddd00", "name": "The products of a catalog hierarchy.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5bc5f42-3b58-44dc-9536-c24af2779b1d", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "hierarchies", ":hierarchy_id", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog hierarchy ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "hierarchy_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e4dd975-19fc-4d1b-8165-f9669c535085", "name": "Get a Node's Products", "request": { "name": "Get a Node's Products", "description": { "content": "Returns the products associated with the specified hierarchy node in the catalog. The products must be in the `live` status. If the products have been curated then the products are returned in the order specified in the `curated_products` attribute. A product that is curated has the `\"curated_product\": true` attribute displayed.\n\nIf you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog is retrieved. See [Resolving catalog rules](/docs/api/pxm/catalog/rules#resolving-catalog-rules).\n\nYou can see the parent nodes a product is associated with in the `bread_crumbs` and `bread_crumb_nodes` metadata for each product. This is useful if you want to improve how your shoppers search your store, for example. See [Product and Node Associations in Breadcrumb Metadata](/guides/How-To/Catalogs/breadcrumbs).\n\n### Filtering\n\nThis endpoint supports filtering. For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering). The following operators and attributes are available when filtering on this endpoint.\n\n| Operator | Description | Supported Attributes | Example |\n|:---|:------------------------------------------------------------------------------------------------|:---------------------------------------------------------|:--- |\n| `Eq` | Checks if the values of two operands are equal. If they are, the condition is true. For `product_types` and `tags`, you can only specify one. For example, `filter=eq(product_types,child)`. | `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=eq(name,some-name)` |\n| `In` | Checks if the values are included in the specified string. If they are, the condition is true. For `product_types` and `tags`, you can specify more than one. For example, `filter=in(product_types,child,bundle)`. | `id`, `name`, `sku`, `slug`, `manufacturer_part_num`, `upc_ean`, `product_types`, `tags` | `filter=in(id,some-id)` |\n\n### Building breadcrumbs in a storefront\n\nIn a catalog, you can use the nodes directly attached to a product to build breadcrumbs in your storefront. This eliminates the need for additional queries to fetch hierarchy or parent node details. Each node contains all the necessary information in `breadcrumbs` metadata, such as its own details and the details of its parent hierarchy/node(s), to construct the complete breadcrumb path without requiring additional queries.\n\nAn example is shown below:\n\n`filter=in(id,c83bfe55-0d87-4302-a86d-ab19e7e323f1,6003d7ef-84f3-49bb-a8bd-4cbfa203dcbb)`\n\n- Specify the node IDs directly attached to the product in the filter expression.\n- You can include as many node IDs as required.\n- It does not matter what order you specify the node IDs. The nodes are returned in the order they were last updated.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug.\n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "type": "any", "value": "string", "key": "node_id", "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "49a779b9-ffbc-40ae-aade-d541a4d762d3", "name": "The products of a catalog node.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"results\": {\n \"total\": 4050\n },\n \"page\": {\n \"limit\": 6346,\n \"offset\": 7724,\n \"current\": 8009,\n \"total\": 5730\n }\n },\n \"data\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8641,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4579,\n \"max\": 648,\n \"sort_order\": 359,\n \"options\": [\n {\n \"id\": \"3650fe12-a6e4-0b8c-3dde-c87e19667db3\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 4629,\n \"max\": 5507,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {},\n \"key_2\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"d56641bb-03c5-cf03-f3a9-47a522d1c3eb\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"6601bfc0-d6ad-f3f9-8f80-b55666899476\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"19006707-46dc-c2e5-3296-a7c422791510\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"dbe54106-8343-d5b4-a54c-8d8f26cbf966\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"8c7babff-0809-faa3-30a4-80213a2a5e29\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"523ac714-a75a-1496-0f54-1818f934fe57\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2468,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4060,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9404,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8570,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2703,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4888,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7799,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8850,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7393,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1080,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6869,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7296,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2016,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1122,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1627,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1125,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1812,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5322,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7840,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3595,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 758,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6626,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8030,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4093,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5505,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6067,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"18053eae-fdd2-4a01-77fb-961ac1c1843b\",\n \"name\": \"string\",\n \"sort_order\": 4051,\n \"option\": {\n \"id\": \"71490ffd-3d14-e13f-5124-bca23f41ac40\",\n \"name\": \"string\",\n \"sort_order\": 9617,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"7f5ce422-eead-5d6d-176a-721615a79ad5\",\n \"name\": \"string\",\n \"sort_order\": 8131,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"12090e1a-aeb6-168a-d609-568cfe739727\",\n \"name\": \"string\",\n \"sort_order\": 9819,\n \"option\": {\n \"id\": \"ae74e0fd-e532-3725-2143-646af86e1cbc\",\n \"name\": \"string\",\n \"sort_order\": 5399,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"aa005bf8-97fa-78f5-9df8-bec23c142a40\",\n \"name\": \"string\",\n \"sort_order\": 8633,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 9721,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7686,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7480,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8418,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6629,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8186,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2834,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 753,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6289,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6462,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"b69eab08-8b4a-34fd-9f2c-898276082ee2\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 6954,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2289,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 6685,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 3337,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 3294,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 4362,\n \"max\": 8444,\n \"sort_order\": 870,\n \"options\": [\n {\n \"id\": \"87e76e58-3c89-853f-e058-415020061cd8\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1503,\n \"max\": 426,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"a28d1460-77fb-6c9e-9769-5da2ca114478\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"ccf5e985-3077-19dd-c939-2a42f85cc2b5\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"861790fa-696d-91ff-81b1-bc20be7c9565\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"859b83ee-2eee-c33b-4806-0fc0258b5e66\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c3d7e2b7-835c-7011-f6fb-5659bee07c9f\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"de2582a8-8f44-d360-d6ba-ef91936fcd72\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3181,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6444,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6001,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7933,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5839,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3473,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1022,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6222,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6730,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8701,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8023,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 143,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5938,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1867,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9956,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4635,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4593,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4437,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"26eb8f61-4071-6363-e2e6-6c84f751386f\",\n \"name\": \"string\",\n \"sort_order\": 6403,\n \"option\": {\n \"id\": \"8cabf948-3011-864c-9e92-49fccfc8b1a6\",\n \"name\": \"string\",\n \"sort_order\": 9640,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"526a293a-1a4d-a5f6-e0e4-5d3daf8a69bd\",\n \"name\": \"string\",\n \"sort_order\": 45,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"0d653928-f3de-63f6-3187-dba04ba6b375\",\n \"name\": \"string\",\n \"sort_order\": 9429,\n \"option\": {\n \"id\": \"70fc21cb-8b35-0dae-9d48-6a8d6ef5cc48\",\n \"name\": \"string\",\n \"sort_order\": 2143,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"3725fbf6-43e7-3919-0617-3e5f8d0ce85b\",\n \"name\": \"string\",\n \"sort_order\": 2968,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7466,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 475,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7908,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 778,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5695,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8397,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9553,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1846,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6729,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5578,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7709,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"b011d261-dfbd-d24c-0181-b08d7c798bcc\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://TMKSTUBqnKlEDgVhWbdFmfm.gphaeC2j8ylKagQ72ppOqOIKdIokGU37CGjBvmFt\",\n \"first\": \"https://RfgMHYKOAjvAJJSxmiYIBVfqETSVRVG.sjllRbuyGZ,2BRxodjZdQnjV1Oc41tAmp1fWyHXfFvL9C4JYlfQVF9\",\n \"last\": \"https://sCurecOAMXXcsGuKEVkgEomvqC.vzmbuto8I6G65rkAgUsjF8snTzyzi\",\n \"prev\": \"http://bbSiyUYlXT.lik0zd.FlnuY1msVt,6fnncWeIisSGjce4Z,blBUTIaBmF7aw\",\n \"next\": \"https://NxTgUjKRYAyKhsdqGXmJfqv.iwSNbOX6hq3sje14COG+bDzpHScpjnkR4SM6eQWEUqFwCFKIcA6-Up4C2WuYJqB\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77bab2a2-988d-427d-a2d5-88199100cdaf", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "nodes", ":node_id", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "This endpoints support filtering. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4521" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. You would normally increment the page offset by multiples of the page limit to paginate through the results.", "type": "text/plain" }, "key": "page[offset]", "value": "4586" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The catalog node ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "node_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cf761a12-207d-47f4-9d13-f7d1a8b9791c", "name": "Configure a Shopper Bundle", "request": { "name": "Configure a Shopper Bundle", "description": { "content": "Once you have configured your product bundles, you can display them in your storefront in your published catalog. Depending on how you have configured the minimum and maximum values for the product options in your components, you can allow your shoppers to choose which products they want to select. For example, you can enable a shopper to select 1 or more product options from a list of 10, giving your shoppers greater flexibility when selecting products in your store front.\n\n- Products must be in a `live` status.\n- If you have not specified any minimum or maximum values for the product options in your components, your shoppers can select any combination of product options.\n\nIf you have configured minimum and maximum values using [Create a Bundle](/docs/api/pxm/products/create-product), this becomes part of the `bundle_configuration`. You can check how your bundle is configured using [Get a product in a catalog release](/docs/api/pxm/catalog/get-product) in `bundle_configuration` under `meta`. The `bundle_configuration` forms the body of the request.\n\nThe response updates the `bundle_configuration` with the product options the shopper selects. The `meta` data is updated with the `meta` data of the selected product options. In your storefront, you could display this as a summary of the product options a shopper has selected.\n\n### Including Resources\n\nUsing the `include` parameter, you can retrieve top-level resources, such as, files or main image, bundle component products and product attributes, such as SKU or slug. \n\n| Parameter | Required | Description |\n| :---------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\nSee [**Including Resources**](/guides/Getting-Started/includes).\n", "type": "text/plain" }, "url": { "path": [ "catalog", "products", ":product_id", "configure" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "type": "any", "value": "string", "key": "product_id", "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b59c78ba-d1a8-4b16-b840-3eb9c3ba71ec", "name": "The configured product of a catalog.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "configure" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 8086,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 3771,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 8040,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 2541,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6572,\n \"max\": 3893,\n \"sort_order\": 6714,\n \"options\": [\n {\n \"id\": \"3ea5a067-7935-6059-136c-be32c630257f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 1410,\n \"max\": 1717,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_2\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_3\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n },\n \"key_2\": {\n \"key_0\": {},\n \"key_1\": {}\n },\n \"key_3\": {\n \"key_0\": {},\n \"key_1\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"55d761a8-ea5a-3a55-f15a-68b05687c3aa\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"c98dff34-e9ab-7cee-d2e6-18a7e7d26805\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"6063f886-3259-4c75-bbaf-a7cae02e5c34\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"adbf4783-de61-632a-f12d-eb179358df3a\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"fd7d3fba-773a-e772-af12-8ba6c34f9504\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"ddae7cf3-a34b-7b35-97e5-24f7139843e2\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3235,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3366,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6373,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1168,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6896,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4624,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1951,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4988,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7376,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4893,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_4\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3899,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3062,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9144,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2255,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 754,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4212,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9828,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2037,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4251,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2536,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4524,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_3\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8338,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3972,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3932,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7084,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6443,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 287,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7136,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4017,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8315,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9892,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5819,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3574,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4327,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4464,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3694,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2083,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2589,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_2\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1521,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2405,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6213,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1071,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4986,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8005,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6762,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3097,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"9f303b4d-5cfc-37ba-96cf-34452a9a1ae7\",\n \"name\": \"string\",\n \"sort_order\": 9647,\n \"option\": {\n \"id\": \"8323c02b-902a-ba60-0703-81858f7d3b95\",\n \"name\": \"string\",\n \"sort_order\": 3652,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"e4176512-f735-cda5-3d05-74fcfc52a96d\",\n \"name\": \"string\",\n \"sort_order\": 5471,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"79d9f2e7-80d9-dd31-514a-542761f9dd61\",\n \"name\": \"string\",\n \"sort_order\": 275,\n \"option\": {\n \"id\": \"59ff712d-8976-a1e0-26fe-4115ac4768b8\",\n \"name\": \"string\",\n \"sort_order\": 1297,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"df480b71-cb3e-e243-dc34-8e758841bee1\",\n \"name\": \"string\",\n \"sort_order\": 9717,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n },\n \"key_1\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_1\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n },\n \"key_2\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 7985,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 4369,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"minimum_quantity\": 3384,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_3\": {\n \"minimum_quantity\": 4664,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_4\": {\n \"minimum_quantity\": 9009,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6712,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7364,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9408,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8731,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5618,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5901,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 3853,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5973,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2571,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3842,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1526,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7674,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n },\n \"included\": {\n \"main_images\": [\n {\n \"id\": \"231234ae-c8a2-a97b-12d3-f70a596cbb3b\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ],\n \"component_products\": [\n {\n \"attributes\": {\n \"published_at\": \"1970-01-01T00:00:00.000\",\n \"base_product\": false,\n \"base_product_id\": \"cdf574bc-e36e-48fc-9eac-01c87839b285\",\n \"commodity_type\": \"physical\",\n \"curated_product\": true,\n \"upc_ean\": \"0123456\",\n \"manufacturer_part_num\": \"mfn1\",\n \"tags\": [\n \"tag-a\"\n ],\n \"price_modifiers\": [\n \"modifier-1\"\n ],\n \"created_at\": \"1970-01-01T00:00:00.000\",\n \"description\": \"This is a product\",\n \"name\": \"Blue shirt\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5194,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"minimum_quantity\": 2897,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"min\": 6811,\n \"max\": 2257,\n \"sort_order\": 5526,\n \"options\": [\n {\n \"id\": \"bd1462dc-c781-39c3-faee-b31ef2d5111f\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 2268,\n \"max\": 4050,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"min\": 6606,\n \"max\": 8178,\n \"sort_order\": 1361,\n \"options\": [\n {\n \"id\": \"1ea01de2-85ac-c07c-40e5-6a9d901c6b39\",\n \"type\": \"product\",\n \"quantity\": 2,\n \"min\": 6130,\n \"max\": 6754,\n \"sort_order\": 15,\n \"default\": true,\n \"product_should_be_substituted_with_child\": true,\n \"excluded_children\": [\n \"2d491d1c-729d-43d7-a2d2-e0a56edab43d\"\n ]\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n },\n \"key_1\": {\n \"name\": \"Message\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 255\n }\n }\n ],\n \"required\": false\n }\n },\n \"sku\": \"blue-shirt\",\n \"slug\": \"blue-shirt\",\n \"status\": \"live\",\n \"external_ref\": \"string\",\n \"updated_at\": \"1970-01-01T00:00:00.000\",\n \"extensions\": {\n \"key_0\": {\n \"key_0\": {}\n },\n \"key_1\": {\n \"key_0\": {}\n }\n }\n },\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {\n \"parent\": {\n \"data\": {\n \"id\": \"aa25553a-1d5d-0328-2e73-0811bf2da5f7\",\n \"type\": \"product\"\n }\n },\n \"children\": {\n \"data\": [\n {\n \"id\": \"3964868e-19e4-99c6-9354-996042d2769e\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"files\": {\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"44795b12-056a-af98-7ce0-1e7573b14460\",\n \"created_at\": \"1970-01-01T00:00:00.000\"\n }\n ]\n },\n \"main_image\": {\n \"data\": {\n \"type\": \"main_image\",\n \"id\": \"a4970b1e-3929-871d-f398-852fd883c4ac\"\n }\n },\n \"component_products\": {\n \"data\": [\n {\n \"id\": \"c6668deb-a1fc-04ce-adeb-fdec06b03754\",\n \"type\": \"product\"\n }\n ],\n \"links\": {\n \"self\": \"string\"\n }\n },\n \"custom_relationships\": {\n \"data\": [\n {\n \"id\": \"259d9dbd-023d-b58a-3794-d9af0b698123\",\n \"type\": \"product\"\n }\n ],\n \"links\": {}\n }\n },\n \"type\": \"product\",\n \"meta\": {\n \"bread_crumbs\": {\n \"key_0\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"key_1\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ]\n },\n \"bread_crumb_nodes\": [\n \"8dbb35b2-ef04-477e-974d-e5f3abe6faae\"\n ],\n \"catalog_id\": \"362a16dc-f7c6-4280-83d6-4fcc152af091\",\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8565,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 117,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"catalog_source\": \"pim\",\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9699,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7841,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n },\n \"component_products\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3501,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1281,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1482,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4305,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9865,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3936,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8982,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6785,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6855,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8345,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6123,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8207,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6358,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7490,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6076,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_1\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 6949,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5425,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7829,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2344,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_3\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 4605,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2929,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 788,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9934,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9522,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6658,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6499,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9260,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_2\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2769,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 6245,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 5041,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7104,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7295,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 9032,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2131,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5166,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8164,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 681,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 4274,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 523,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n },\n \"key_3\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5283,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 8525,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7866,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7538,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"pricebook_id\": \"f5466169-0037-460c-b181-b02682b6f4de\",\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5861,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 7820,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 6438,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5159,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7962,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2390,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 8286,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 422,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n },\n \"key_1\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 8550,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1120,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 7579,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 2230,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ]\n }\n },\n \"component_product_data\": {\n \"key_0\": {\n \"value\": \"\"\n },\n \"key_1\": {\n \"value\": \"\"\n },\n \"key_2\": {\n \"value\": \"\"\n },\n \"key_3\": {\n \"value\": \"\"\n }\n },\n \"price_modifiers\": {\n \"key_0\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_1\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n },\n \"key_2\": {\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 955,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 4664,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 2632,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3386,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n },\n \"variation_matrix\": {},\n \"variations\": [\n {\n \"id\": \"19ecf97f-58f7-d19f-d60b-ea2243454f1e\",\n \"name\": \"string\",\n \"sort_order\": 41,\n \"option\": {\n \"id\": \"35189601-378a-56dc-9ad0-20d39bff3cd8\",\n \"name\": \"string\",\n \"sort_order\": 826,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"0598449a-8f36-3769-a025-af3f4c314316\",\n \"name\": \"string\",\n \"sort_order\": 3468,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"child_option_ids\": [\n \"string\"\n ],\n \"child_variations\": [\n {\n \"id\": \"02506a63-78a5-f2e4-97a0-fac868211709\",\n \"name\": \"string\",\n \"sort_order\": 4478,\n \"option\": {\n \"id\": \"96ef6a16-e30b-719d-e928-1f4ec9295b6f\",\n \"name\": \"string\",\n \"sort_order\": 1917,\n \"description\": \"string\"\n },\n \"options\": [\n {\n \"id\": \"8d7c07f0-41be-3d78-dc71-eb30b12a0ef7\",\n \"name\": \"string\",\n \"sort_order\": 9233,\n \"description\": \"string\"\n }\n ]\n }\n ],\n \"product_types\": [\n \"string\"\n ],\n \"language\": \"en-GB\",\n \"custom_relationships\": [\n \"string\"\n ],\n \"available_prices\": [\n {\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n \"sales\": {\n \"key_0\": {\n \"schedule\": {\n \"valid_from\": \"2020-09-22T09:00:00\",\n \"valid_to\": \"2020-09-22T09:00:00\"\n },\n \"currencies\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 5,\n \"amount\": 100\n }\n }\n }\n }\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"minimum_quantity\": 768,\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n }\n }\n }\n }\n ],\n \"alternative_prices\": [\n {\n \"name\": \"string\",\n \"pricebook_id\": \"string\",\n \"shopper_attributes\": {\n \"key_0\": \"string\"\n },\n \"sale_id\": \"string\",\n \"sale_expires\": \"2025-07-07T14:30:00Z\",\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_2\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3306,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 5723,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 1746,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1604,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"tiers\": {\n \"key_0\": {\n \"original_price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"price\": {\n \"key_0\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"key_1\": {\n \"amount\": 100,\n \"includes_tax\": false\n }\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 5798,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 1529,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n },\n \"original_display_price\": {\n \"with_tax\": {\n \"amount\": 9247,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n },\n \"without_tax\": {\n \"amount\": 3661,\n \"currency\": \"USD\",\n \"formatted\": \"$475.00\",\n \"float_price\": 475\n }\n }\n }\n }\n }\n ],\n \"available_pricebook_ids\": [\n \"string\"\n ]\n }\n }\n ],\n \"files\": [\n {\n \"id\": \"74ddf67f-a343-7fd3-02ca-f268c360c059\",\n \"type\": \"file\",\n \"file_name\": \"file_name.jpg\",\n \"mime_type\": \"image/jpeg\",\n \"file_size\": 36000,\n \"public\": true,\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-10-11T13:02:25.293Z\"\n },\n \"dimensions\": {\n \"width\": 1800,\n \"height\": 1000\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/ddc28c74-a7df-46be-b262-8fa69a6e7d52\"\n },\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\",\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"self\": \"https://GIYpLJerwwqvVqnQoSMBbhucryrau.azN,evXBHWPsqmKtKRgWBb6jLOFCks\",\n \"first\": \"http://TyLwhmfNPhtCSnJUmLNVceDeeZmXvoCPd.koldAMzgQU3LKJFpDxBuFGnswkMO.CzJ8Oe100LGdC\",\n \"last\": \"https://XnLoZTdueTG.ypx,Re1u\",\n \"prev\": \"http://mjHGDnmtifAdCVJApwuQe.jqoO7662XJNpdOevmJdXeZu2Pjn7P\",\n \"next\": \"https://rNuAsBrWiTcElHgbwhMHsDwh.lfuvHbbxqVrTjRLkvOLuSrYBxLmD0BEooezXeaPlpL5JDYcH+p1Z+xZNw\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "913245a2-03e4-4fdc-b045-488269a1dd7c", "name": "The unexpected error.", "originalRequest": { "url": { "path": [ "catalog", "products", ":product_id", "configure" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The product ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "product_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"selected_options\": {\n \"games\": {\n \"p292e1db-c919-4d2f-984a-c2ddc79df024\": 2\n },\n \"consoles\": {\n \"759ce0d7-e248-4f57-8ee1-6fd81a1b3c0a\": 1\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n },\n {\n \"detail\": \"not processable\",\n \"status\": \"422\",\n \"title\": \"There was a problem processing your request.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Search", "description": "The Search API enables you to search for products in your published catalogs. Search provides powerful capabilities including full-text search, filtering, faceting, and sorting to help shoppers find products quickly and efficiently.\n\n### How Search Works\n\nWhen you publish a catalog with search enabled, the catalog's products are automatically indexed for search. The search index contains product data optimized for fast querying, including product names, descriptions, SKUs, categories, prices, and any custom fields you've configured.\n\nThere are two types of search operations:\n\n- **Search**: Execute a single search query against a catalog. Use the GET endpoint for simple searches with query parameters.\n- **Multi-search**: Execute multiple search queries in a single request. Use the POST endpoint to batch searches together for improved performance.\n\n### Search Features\n\n- **Full-text search**: Search across product names, descriptions, SKUs, and custom fields with typo tolerance and relevance ranking\n- **Filtering**: Narrow results using conditions on product attributes, categories, prices, and custom fields\n- **Faceting**: Get aggregated counts for attribute values to build dynamic navigation and refinement options\n- **Sorting**: Order results by price, name, custom fields, or relevance score\n- **Highlighting**: Get highlighted snippets showing where search terms match in product fields\n- **Autocomplete**: Get search suggestions as shoppers type their queries\n\n### Shopper Context\n\nSearch results are personalized based on the shopper's context. The system automatically determines which catalog and prices to use based on:\n\n- **Channel**: The shopping experience (web, mobile, B2B portal)\n- **Account**: For B2B scenarios, the account and parent accounts\n- **Customer**: The logged-in customer's segment\n- **Tags**: Custom context tags for advanced segmentation\n\nThis context is provided via request headers and is used to resolve the appropriate catalog rules and price books.\n\n### Admin vs Shopper Endpoints\n\n- **Shopper endpoints** (`/pcm/catalog/search`, `/pcm/catalog/multi-search`): Use shopper context headers to automatically resolve the correct catalog and prices.\n- **Admin endpoints** (`/pcm/catalogs/{catalog_id}/releases/{release_id}/search`): Directly specify the catalog and release to search, useful for previewing releases or testing.\n", "item": [ { "id": "9bb6a273-f77f-4f92-9090-0a0fac0db7a0", "name": "Multi-search", "request": { "name": "Multi-search", "description": { "content": "Execute one or more searches in a single request.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalog", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0534f7c6-bf88-4aa2-8f93-d6f95a0f4532", "name": "Multi-search results", "originalRequest": { "url": { "path": [ "pcm", "catalog", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25\n },\n {\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25\n }\n ],\n \"included\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89e999a5-4008-4571-b5cc-d1fff1af62fb", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalog", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Invalid Filter\",\n \"status\": \"400\",\n \"detail\": \"Could not parse the filter query.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83369c1e-e035-4278-b4b5-9e7212a9bccb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalog", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c076296e-9ec2-4f0c-a337-d8b4299a2ae0", "name": "Admin Multi-search", "request": { "name": "Admin Multi-search", "description": { "content": "Execute one or more searches in a single request.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ded27576-8b34-42c1-a450-d4c49f92cc4b", "name": "Multi-search results", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25\n },\n {\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25\n }\n ],\n \"included\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "524e6d1f-3a3b-481e-99e8-a9f60df672ee", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Invalid Filter\",\n \"status\": \"400\",\n \"detail\": \"Could not parse the filter query.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "817f18cb-02b8-4033-a480-7f9a3eb300ee", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "multi-search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"searches\": [\n {\n \"type\": \"search\",\n \"highlight_full_fields\": \"name,description\",\n \"q\": \"search query\",\n \"facet_by\": \"meta.search.nodes.name\",\n \"filter_by\": \"meta.search.nodes.name:=Electronics && price.float_price:>=10.00\",\n \"sort_by\": \"price.amount:asc,extensions.products(Specification).rating:desc\",\n \"max_facet_values\": 10,\n \"page\": 1,\n \"per_page\": 20\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dcce3d2b-5a51-4332-bcd2-fefec1911f17", "name": "Search", "request": { "name": "Search", "description": { "content": "Execute search.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalog", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "79732b4c-7557-4f9d-b5ed-c98da36ffa0d", "name": "Search results", "originalRequest": { "url": { "path": [ "pcm", "catalog", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25,\n \"included\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b004191-2205-4313-8a7e-bd2f279cff6f", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalog", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Invalid Filter\",\n \"status\": \"400\",\n \"detail\": \"Could not parse the filter query.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e23a2138-051c-4d73-83a8-ac0b1983bed5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalog", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "The list of channels in which this catalog can be displayed. A channel is the shopping experience, such as a mobile app or web storefront. If empty, the catalog rule matches all channels. The channel will eventually be included in the bearer token that is used for authorization, but currently, you must set the `EP-Channel` header in your requests.", "type": "text/plain" }, "key": "EP-Channel", "value": "string" }, { "disabled": false, "description": { "content": "Tags are used to refine the eligibility criteria for a rule. Requests populate the catalog rule tag using the `EP-Context-Tag` header.", "type": "text/plain" }, "key": "EP-Context-Tag", "value": "string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c104be93-a2bc-4cd3-b0fe-9183a5f05298", "name": "Admin Search", "request": { "name": "Admin Search", "description": { "content": "Execute search.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [ { "type": "any", "value": "string", "key": "catalog_id", "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "release_id", "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5f2f8b71-ffcb-4e37-b009-6d5367353282", "name": "Search results", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"type\": \"search\",\n \"facet_counts\": [\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n },\n {\n \"counts\": [\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n },\n {\n \"count\": 42,\n \"highlighted\": \"electronics\",\n \"value\": \"electronics\"\n }\n ],\n \"field_name\": \"category\",\n \"sampled\": false,\n \"stats\": {}\n }\n ],\n \"found\": 150,\n \"hits\": [\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n },\n {\n \"document\": {\n \"attributes\": {},\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"relationships\": {},\n \"type\": \"product\",\n \"meta\": {}\n },\n \"highlight\": {}\n }\n ],\n \"out_of\": 150,\n \"page\": 1,\n \"request_params\": {},\n \"search_cutoff\": false,\n \"search_time_ms\": 25,\n \"included\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4c9c0b8-f1e5-45c5-9cba-9cf4e1ed2452", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Invalid Filter\",\n \"status\": \"400\",\n \"detail\": \"Could not parse the filter query.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e51c5a6-6361-4ab4-924e-e4087d360bd6", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", ":catalog_id", "releases", ":release_id", "search" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,files" }, { "disabled": false, "description": { "content": "The slug of the search profile to use for this search. Do not specify to use default search profile.", "type": "text/plain" }, "key": "search_profile", "value": "clothing" }, { "disabled": false, "description": { "content": "Type of search operation to perform (This can only be one of search,autocomplete)", "type": "text/plain" }, "key": "type", "value": "search" }, { "disabled": false, "description": { "content": "Comma-separated list of fields to highlight", "type": "text/plain" }, "key": "highlight_full_fields", "value": "name,description" }, { "disabled": false, "description": { "content": "(Required) Search query", "type": "text/plain" }, "key": "q", "value": "search query" }, { "disabled": false, "description": { "content": "Specifies which fields to use for generating facets in search results. See [faceting](/guides/How-To/Catalogs/Search/faceting) for more details.", "type": "text/plain" }, "key": "facet_by", "value": "meta.search.nodes.name" }, { "disabled": false, "description": { "content": "Applies conditions to narrow down search results based on specific field values. See [filtering](/guides/How-To/Catalogs/Search/filtering) for more details.", "type": "text/plain" }, "key": "filter_by", "value": "meta.search.nodes.name:=Electronics && price.float_price:>=10.00" }, { "disabled": false, "description": { "content": "Orders search results by specified fields. See [sorting](/guides/How-To/Catalogs/Search/sorting) for more details.", "type": "text/plain" }, "key": "sort_by", "value": "price.amount:asc,extensions.products(Specification).rating:desc" }, { "disabled": false, "description": { "content": "Maximum number of facet values to return", "type": "text/plain" }, "key": "max_facet_values", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "per_page", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the catalog to query", "type": "text/plain" }, "type": "any", "value": "string", "key": "catalog_id" }, { "disabled": false, "description": { "content": "(Required) The unique ID of a published release of the catalog or `latestPublished` for the most recently published version", "type": "text/plain" }, "type": "any", "value": "string", "key": "release_id" } ] }, "header": [ { "disabled": false, "description": { "content": "The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).", "type": "text/plain" }, "key": "accept-language", "value": "string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be used to lookup product prices from when the catalog supports price segmentation. The first pricebook will be highest priority (if more than one is supplied) and the rest in descending priority order. Used only for admin endpoints that dont support shopper context lookup.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-For-Price-Segmentation-Preview", "value": "string,string" }, { "disabled": false, "description": { "content": "Supply a comma delimited list of pricebook ids to be listed in meta sections available prices . 'all' is a permitted value and will ensure all available prices for a product are shown. 'all' is not recommended if there are lots(10+) of available prices due the large response size.", "type": "text/plain" }, "key": "EP-Pricebook-IDs-Of-Available-Prices-To-Show", "value": "string,string" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "EP-Simulated-Shopper-Date", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Indexable Fields", "description": "Indexable Fields allow you to extend the search schema by adding custom product attributes to the search index. By default, the search index includes standard product fields like name, description, SKU, and categories. Indexable Fields let you configure which additional fields are indexed, enabling searching, filtering, faceting, and sorting on custom attributes.\n\n### When to Use Indexable Fields\n\nUse Indexable Fields when you want to:\n\n- **Search custom attributes**: Enable full-text search on custom product fields like brand, material, or specifications\n- **Filter by custom attributes**: Allow shoppers to filter products by custom fields like color, size, or rating\n- **Facet on custom attributes**: Display aggregated counts for custom field values in your navigation\n- **Sort by custom attributes**: Order search results by custom numeric fields like rating or popularity\n\n### How Indexable Fields Work\n\n1. **Create indexable fields**: Define which fields should be indexed, specifying field name and options (facetable, sortable, locale)\n2. **Reindex catalogs**: After creating or modifying indexable fields, reindex your catalog releases to include the new fields\n3. **Use in searches**: Once reindexed, you can reference the indexed fields in your search queries for filtering, faceting, and sorting\n\n### Field Configuration\n\nEach indexable field has the following configuration options:\n\n| Option | Description |\n|-------------|-------------------------------------------------------------------------------------------|\n| `name` | The field path — see **Field Types** below for supported formats |\n| `facetable` | When `true`, the field can be used for faceting to show aggregated value counts |\n| `sortable` | When `true`, the field can be used for sorting results |\n| `locale` | Language code for text tokenization, defaults to `en` for English |\n\n### Field Types\n\nTwo categories of fields can be indexed:\n\n#### Extension Fields\n\nFields from your product extension templates, following the pattern `extensions.products().`:\n\n- `` is the slug of your product extension template\n- `` is the name of the field within that template\n- The field must exist and be enabled in the flows service\n- Only enumerated string fields, numeric fields, and boolean fields can be faceted\n\n**Example**: For a product extension template with slug `Details` containing a field `brand`, the indexable field name would be `extensions.products(Details).brand`.\n\n#### Custom Attribute Fields\n\nMerchant-defined key/value attributes stored directly on products:\n\n- `shopper_attributes.` — visible in shopper and admin catalog API responses and available for filtering, sorting, and faceting in both shopper and admin search\n- `admin_attributes.` — available for filtering and sorting in both shopper and admin search; not returned in search response payloads\n- `` must be no longer than **64 characters** and can only contain alphanumeric characters, underscores (`_`), and hyphens (`-`).\n- Attribute fields are always typed as `string`\n- Faceting and sorting can be enabled\n\n**Examples**: `shopper_attributes.fabric`, `admin_attributes.internal_grade`\n\n### Reindexing Requirement\n\nChanges to indexable fields require reindexing your catalog releases. The system detects when indexes are out of sync and you can use the reindex endpoint to update them. See [Jobs](/docs/api/pxm/catalog-search/jobs) for reindexing operations.\n", "item": [ { "id": "64542086-b7e8-4a46-a1e6-ec0ac1ae7e1d", "name": "Create indexable fields", "request": { "name": "Create indexable fields", "description": { "content": "Specify additional fields to be indexed.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "aa691d0b-c424-4da3-b119-46623dec60cc", "name": "Successfully created indexable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"type\": \"string\",\n \"sortable\": true\n }\n ]\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8d24b18-ef39-4eae-94e8-e25dcc946178", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebca752a-1d5a-4163-904e-f25c4756771a", "name": "Conflict - reindexing job queued or in progress", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9dca4be3-5ad5-4ed0-b54d-9dc5a9d8ec27", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "406ff045-9be6-4a63-bf9e-a88113940a5d", "name": "List indexable fields", "request": { "name": "List indexable fields", "description": { "content": "List indexable fields.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4fc8102c-3ce9-47da-b71a-b1509d5990a7", "name": "List indexable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"type\": \"string\",\n \"sortable\": true\n }\n ]\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n },\n {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"type\": \"string\",\n \"sortable\": true\n }\n ]\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c42f9623-42a3-4780-8927-af5814837759", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26f71bd6-b24b-4c96-aa9b-627bdc872798", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "95beba15-b573-408d-b707-9890e1002474", "name": "Get indexable fields", "request": { "name": "Get indexable fields", "description": { "content": "Get additional fields to be indexed.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id", "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "06a8eea1-274c-46c7-ba99-2fda57d0b7d5", "name": "Get indexable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"type\": \"string\",\n \"sortable\": true\n }\n ]\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76f88eb6-02b7-4f8d-b347-f58e372dc2cd", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "310d567f-4fab-47ce-b611-5939eec83377", "name": "Indexable fields not found", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "039f1821-773f-46e7-bece-d274a6f4bf4c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56ac0a15-e17b-4e06-aa96-6d6722ce4d90", "name": "Update indexable fields", "request": { "name": "Update indexable fields", "description": { "content": "Update additional fields to be indexed.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id", "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "53f1cd0f-5a36-4636-b130-4f5367a2cc45", "name": "Successfully updated indexable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"8fccaa19-dba9-4621-8d11-31a222a68c7c\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"type\": \"string\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"type\": \"string\",\n \"sortable\": true\n }\n ]\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8285e2ee-8452-422d-8b3f-30cb3a81790e", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1054718d-776b-4f99-8406-70db265a45ab", "name": "Permission denied - indexable fields owned by the organization", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "982cd8db-da04-4249-b6ad-4f60d21fa231", "name": "Indexable fields not found", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6729a24-2ba9-42cb-af9e-bc0ecfa553ed", "name": "Conflict - reindexing job queued or in progress", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f4a3ec4-a8c7-402e-ad1a-2e97c6a00309", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_indexable_fields\",\n \"attributes\": {\n \"fields\": [\n {\n \"name\": \"extensions.products(clothing).color\",\n \"facetable\": false,\n \"sortable\": false,\n \"locale\": \"en\"\n },\n {\n \"name\": \"shopper_attributes.fabric\",\n \"facetable\": false,\n \"sortable\": false\n },\n {\n \"name\": \"admin_attributes.internal_grade\",\n \"sortable\": true\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1ce9a3af-85bd-4b43-85bb-c6daddee1156", "name": "Delete indexable fields", "request": { "name": "Delete indexable fields", "description": { "content": "Delete additional fields to be indexed.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id", "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "a9412147-43f1-44f9-8af7-20b28d199ae1", "name": "Successfully deleted indexable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d502505c-e076-4204-83f9-42545103f0d2", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c8109fd-4752-405e-b271-81119b1ea46b", "name": "Permission denied - indexable fields owned by the organization", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "849a5837-bf4c-443a-ac80-6660d678b0c8", "name": "Conflict - reindexing job queued or in progress", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4620b14-b43b-4185-9d64-c3a31f51dbb4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "indexable-fields", ":indexable_fields_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the indexable fields", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "indexable_fields_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Searchable Fields", "description": "The Searchable Fields API returns a list of all fields available for searching, filtering, faceting, and sorting in your search queries. This includes both the standard product fields that are indexed by default and any custom fields you've added through Indexable Fields.\n\n### Using Searchable Fields\n\nUse this endpoint to:\n\n- **Discover available fields**: See all fields that can be used in search queries\n- **Build dynamic UIs**: Programmatically generate filter and facet options based on available fields\n- **Validate configurations**: Verify that your indexable fields have been properly added to the schema\n\n### Field Properties\n\nEach searchable field includes:\n\n| Property | Description |\n| --- | --- |\n| `name` | The field name to use in search queries |\n| `type` | The data type (`string`, `int32`, `int64`, `float`, `bool`) |\n| `facetable` | Whether the field can be used for faceting |\n| `sortable` | Whether the field can be used for sorting |\n| `locale` | The language code for text fields |\n\n### Standard vs Custom Fields\n\n- **Standard fields**: Built-in fields like `name`, `description`, `sku`, `meta.search.nodes.name` that are always available\n- **Custom fields**: Fields added through Indexable Fields from your product extensions\n", "item": [ { "id": "3175a85a-530d-4904-af20-b95d41a52b84", "name": "List searchable fields", "request": { "name": "List searchable fields", "description": { "content": "List searchable fields.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "searchable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "abd9e9f4-eb12-4e97-aa06-b2e635f9e8c9", "name": "List searchable fields", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "searchable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"name\",\n \"type\": \"catalog_searchable_field\",\n \"attributes\": {\n \"name\": \"name\",\n \"type\": \"string\",\n \"facetable\": true,\n \"sortable\": true,\n \"locale\": \"en\"\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n },\n {\n \"id\": \"name\",\n \"type\": \"catalog_searchable_field\",\n \"attributes\": {\n \"name\": \"name\",\n \"type\": \"string\",\n \"facetable\": true,\n \"sortable\": true,\n \"locale\": \"en\"\n },\n \"meta\": {\n \"owner\": \"organization\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 100\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c6fb7a0-515c-41df-bfdd-5776d0fd8718", "name": "Bad request - invalid search parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "searchable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6dd930bf-6073-4217-a600-8313e92211b1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "searchable-fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Search Profiles", "description": "Search Profiles are configuration objects that control how search queries are executed. They provide a powerful way to customize search relevance, filtering, and ranking without requiring code changes, enabling merchandisers and business users to optimize the search experience.\n\n### How Search Profiles Work\n\nA Search Profile defines:\n\n- **Which fields to search**: Select which product fields are included in search queries\n- **Field weights**: Assign relative importance to each field for relevance ranking\n- **Default filters**: Apply business rules that filter results for all searches\n- **Boost rules**: Promote or demote products based on specific conditions\n- **Match type**: Control how scores from multiple fields are combined\n\nWhen a search request is made, the system uses the specified profile (or the default profile) to configure the search behavior.\n\n### Search Profile Components\n\n| Component | Description |\n|-------------------|-------------------------------------------------------------------------------------------|\n| `slug` | Unique identifier used to reference the profile in search requests |\n| `fields` | List of fields to search with optional weights for relevance ranking |\n| `filters` | Default filter expressions applied to all searches using this profile |\n| `boosts` | Rules for promoting or demoting products based on conditions |\n| `text_match_type` | How to combine scores when multiple fields match (`max_score`, `max_weight`, `sum_score`) |\n\n### Field Weights\n\nField weights control how important each field is when ranking search results. Higher weights mean matches in that field contribute more to the relevance score.\n\n**Example**: A profile with `name` (weight 10) and `description` (weight 5) will rank products with search term matches in the name higher than those with matches only in the description.\n\n### Filters\n\nProfile filters enforce business rules that apply to all searches:\n\n- Ensure only live/published products appear in results\n- Restrict results to specific categories or channels\n- Hide products based on visibility settings\n\nMultiple filters are combined with OR logic, then ANDed with any filters in the search request.\n\n### Boost Rules\n\nBoost rules allow you to promote or demote products in search results:\n\n- **Positive weights**: Push matching products to the top of results\n- **Negative weights**: Push matching products to the bottom (burying)\n- **Zero weight**: No effect on ranking\n\nRules are evaluated in weight order, and the first matching rule determines the product's boost.\n\n### Text Match Types\n\n| Type | Description |\n|--------------|----------------------------------------------------------------------------------------|\n| `max_score` | Uses the highest score from any single matching field. Prioritizes match quality. |\n| `max_weight` | Uses the score from the highest-weighted matching field. Prioritizes field importance. |\n| `sum_score` | Sums weighted scores from all matching fields. Rewards multi-field matches. |\n\n### Default Profile\n\nEach store has a default search profile that is used when no profile is specified in the search request. You can set any profile as the default using the set default endpoint.\n\n### Use Cases\n\n- **A/B testing**: Create multiple profiles with different configurations to test search relevance\n- **Channel optimization**: Different profiles for web, mobile, and B2B channels\n- **Seasonal merchandising**: Profiles that boost seasonal or promotional products\n- **Customer segmentation**: Different ranking strategies for different customer tiers\n", "item": [ { "id": "ab3fa516-e8a8-4774-b96b-8c397f8d401b", "name": "Create search profile", "request": { "name": "Create search profile", "description": { "content": "Create a new search profile.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9e92103b-7c2d-4867-ab27-f7a0951ccd87", "name": "Successfully created search profile", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7a0c6c2-8678-46be-8082-9c142531b094", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c2063b9-da71-4791-a810-4cdf89dd95ed", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "33caf3c5-0965-4f5d-8371-63d31d2a749e", "name": "List search profiles", "request": { "name": "List search profiles", "description": { "content": "List search profiles.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b55aee70-036c-44ec-920a-4cd393d7b3f8", "name": "List search profiles", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n },\n {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 100\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3c6d3a4-d8af-43a5-9da8-53e3535fce24", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a9bf2a3-cd70-47b4-813b-e09e3eb49400", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c1feeee7-6204-42f7-9c42-95633989a5f5", "name": "Get search profile", "request": { "name": "Get search profile", "description": { "content": "Get a search profile.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id", "disabled": false, "description": { "content": "(Required) The unique ID of the search profile or 'default' to retrieve the default search profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8f62ec5d-a30e-4bc0-9b77-bc6d51f59580", "name": "Successfully retrieved search profile", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile or 'default' to retrieve the default search profile.", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc210eb5-c928-4ed4-9bfa-c6d4751dc4f2", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile or 'default' to retrieve the default search profile.", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "232287e0-f631-4d4d-9a81-ac105ba3d589", "name": "Search profile not found", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile or 'default' to retrieve the default search profile.", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "273a925e-33a6-4251-902a-fec94cb61778", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile or 'default' to retrieve the default search profile.", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2d0a06a9-efbc-470b-aa92-0bb8532ec8fa", "name": "Update search profile", "request": { "name": "Update search profile", "description": { "content": "Update a search profile.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id", "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e9749d37-9ec7-418a-b25c-ce13b6f97a61", "name": "Successfully updated search profile", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76718bee-09c5-411c-94a6-43a4a403dc57", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32c25df1-d011-490c-9fc6-53879c6a6320", "name": "Permission denied - search profile owned by the organization", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0dfce69-6b71-4aca-a30d-b79eb5f927f1", "name": "Search profile not found", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54eeed2d-4fbf-4ff2-841c-d191fa283d3c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ed96fa0-925c-480f-8e9d-1bf114ba9465", "name": "Delete search profile", "request": { "name": "Delete search profile", "description": { "content": "Delete a search profile.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id", "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "40687f01-9a26-47df-a5c9-cae5caeb63b5", "name": "Successfully deleted search profile", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4c2b4a08-b0d5-4a9c-859d-4a8bc4e4615c", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8734e1c5-df35-4f78-a0b1-526cce4fec9d", "name": "Permission denied - search profile owned by the organization", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae3b3380-bce9-4f13-99e2-0792955d587a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7900e1b4-5920-4c17-a2f5-3ea7bece51f7", "name": "Set search profile as default", "request": { "name": "Set search profile as default", "description": { "content": "Set a search profile as the default.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id", "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "7cff474c-0f50-4133-ad46-ad1556fd9926", "name": "Successfully updated the search profile", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_profile\",\n \"attributes\": {\n \"slug\": \"default\",\n \"description\": \"Default search profile\",\n \"fields\": [\n {\n \"name\": \"name\",\n \"weight\": 10\n }\n ],\n \"force_use_default_price_for_faceting_and_sorting\": true,\n \"text_match_type\": \"max_score\",\n \"filters\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"exclusions\": [\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\",\n \"meta.search.categories.lvl1:=`All Products > Mens Shoes`\"\n ],\n \"boosts\": [\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n },\n {\n \"condition\": \"meta.search.nodes.name:=\\\\`Electronics\\\\`\",\n \"weight\": 5\n }\n ]\n },\n \"meta\": {\n \"default\": true,\n \"owner\": \"organization\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13b28c00-d67e-499c-ab4a-f43ff4f83516", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5528aeac-c5d5-4387-9b74-fee63a8b4b34", "name": "Permission denied - search profile owned by the organization", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6c926ea-c8fe-41d6-a69d-ef38ff59a572", "name": "Search profile not found", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c49adf91-ad7f-49bf-a8c3-bf2598554c11", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-profiles", ":search_profile_id", "default" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique ID of the search profile", "type": "text/plain" }, "type": "any", "value": "ac107ce9-96ac-4bd5-aa3d-59f40b91279b", "key": "search_profile_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Search Indexes", "description": "Search Indexes represent the indexed data for your catalog releases. Each time a catalog is published with search enabled, a search index is created containing the product data optimized for fast querying.\n\n### Index Status\n\nThe Search Indexes API allows you to view the status of your indexes and identify any that are out of sync. An index becomes out of sync when:\n\n- Indexable fields have been added, modified, or deleted\n- The index failed to build during catalog publishing\n- A reindex is required due to schema changes\n\n### Monitoring Indexes\n\nUse the list endpoint to:\n\n- **View all indexes**: See all search indexes for your store\n- **Check sync status**: Identify indexes that need reindexing\n- **Filter by status**: Find only out-of-sync indexes using the `out_of_sync` query parameter\n\n### Index Information\n\nEach search index includes:\n\n| Property | Description |\n|---------------|---------------------------------------------------------|\n| `catalog_id` | The ID of the catalog this index belongs to |\n| `release_id` | The ID of the catalog release this index was built from |\n| `out_of_sync` | Whether the index needs to be rebuilt |\n\n### Reindexing\n\nWhen indexes are out of sync, use the reindex endpoint in [Jobs](/docs/api/pxm/catalog-search/jobs) to rebuild them. Reindexing ensures your search indexes reflect the current indexable field configuration.\n", "item": [ { "id": "7640eaaf-3166-4980-944a-d0ed2755a7c4", "name": "List search indexes", "request": { "name": "List search indexes", "description": { "content": "List search indexes.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "search-indexes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter search indexes by out of sync status", "type": "text/plain" }, "key": "out_of_sync", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "64cd8f94-275f-431d-be12-f066a0ac58cc", "name": "List search indexes", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-indexes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter search indexes by out of sync status", "type": "text/plain" }, "key": "out_of_sync", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_index\",\n \"meta\": {\n \"catalog_id\": \"ac107ce9-96ac-4bd5-aa3d-59f40b91279b\",\n \"release_id\": \"b2ddd253-d9bd-4344-a18b-581c1e0b25f8\",\n \"out_of_sync\": false,\n \"owner\": \"organization\"\n }\n },\n {\n \"id\": \"805103ff-0a37-4f83-8fe0-95a16039bd98\",\n \"type\": \"catalog_search_index\",\n \"meta\": {\n \"catalog_id\": \"ac107ce9-96ac-4bd5-aa3d-59f40b91279b\",\n \"release_id\": \"b2ddd253-d9bd-4344-a18b-581c1e0b25f8\",\n \"out_of_sync\": false,\n \"owner\": \"organization\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 100\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df1b492a-5e54-4ddc-9856-07efc6cfedac", "name": "Bad request - invalid parameters", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-indexes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter search indexes by out of sync status", "type": "text/plain" }, "key": "out_of_sync", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f13b9eb7-463a-44ca-af3f-7eff6089debe", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "search-indexes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter search indexes by out of sync status", "type": "text/plain" }, "key": "out_of_sync", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Typesense Clusters", "description": "Manage Typesense clusters (provision via jobs; get/list cluster state including status).", "item": [] }, { "name": "Jobs", "description": "Jobs manage the indexing operations for catalog search. When catalogs are published or when reindexing is required, jobs process the product data and build search indexes.\n\n### Job Types\n\n| Type | Description |\n|---------------------------|-----------------------------------------------------------------------------------------------------|\n| `index-release` | Index a specific catalog release. Created automatically when a search-enabled catalog is published. |\n| `delete-release` | Remove the search index for a catalog release. |\n| `reindex-tenant-releases` | Reindex all catalog releases for the store. Use when indexable fields have changed. |\n\n### Job Lifecycle\n\nJobs progress through the following states:\n\n1. **pending**: Job has been created and is waiting to be processed\n2. **processing**: Job is actively indexing products\n3. **complete**: Job finished successfully\n4. **failed**: Job encountered an error\n\n### Automatic Indexing\n\nWhen you publish a catalog with search enabled, an `index-release` job is automatically created. The catalog release remains in a publishing state until the indexing job completes successfully.\n\n### Manual Reindexing\n\nUse the reindex endpoint when:\n\n- You've added, modified, or deleted indexable fields\n- Search indexes are out of sync (check via [Search Indexes](/docs/api/pxm/catalog-search/search-indexes))\n- You need to rebuild indexes after a failure\n\nThe reindex operation creates jobs for all catalog releases that need updating. You can optionally force a full reindex of all releases regardless of their sync status.\n\n### Conflict Handling\n\nOnly one reindexing operation can run at a time. If you attempt to start a reindex while another is in progress, the API returns a 409 Conflict error.\n", "item": [ { "id": "4cd08a6f-5ba9-4bf8-a15d-fbf5fa87d0c8", "name": "Reindex all releases for tenant", "request": { "name": "Reindex all releases for tenant", "description": { "content": "Create a new job to reindex all releases for the tenant.", "type": "text/plain" }, "url": { "path": [ "pcm", "catalogs", "reindex-releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"force_reindex\": 548\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3deb09b2-b6a7-43f4-a2d1-a754f14e0a39", "name": "Reindex tenant releases request successful", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "reindex-releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"force_reindex\": 548\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"4c9efe34-57bb-4117-abed-184008d3ae0a\",\n \"type\": \"job\",\n \"attributes\": {\n \"status\": \"pending\",\n \"type\": \"index-release\",\n \"catalog_id\": \"ac107ce9-96ac-4bd5-aa3d-59f40b91279b\",\n \"catalog_release_id\": \"c12c4e5b-f5e4-4bd0-ac86-9f1202fc27f9\"\n },\n \"meta\": {\n \"errors\": [\n {\n \"detail\": \"Failed to get release\",\n \"context\": {}\n },\n {\n \"detail\": \"Failed to get release\",\n \"context\": {}\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e59b6d2d-3024-40c9-87aa-5f8e2c599589", "name": "Bad request", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "reindex-releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"force_reindex\": 548\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02586942-4c44-45c3-8bce-93dc3674fd32", "name": "Conflict - another reindexing job already queued or in progress", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "reindex-releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"force_reindex\": 548\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n },\n {\n \"status\": \"500\",\n \"title\": \"Internal server error\",\n \"detail\": \"An internal error has occurred.\",\n \"meta\": {\n \"missing_ids\": [\n \"e7d50bd5-1833-43c0-9848-f9d325b08be8\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e74d003-65e6-4409-bd21-97d67ab415af", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "catalogs", "reindex-releases" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"force_reindex\": 548\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Cart Management", "description": "A Cart contains the product and custom cart items that a user intends to purchase. After a Cart is ready for Checkout, you can use the [Checkout endpoint](/docs/api/carts/checkout) to convert the cart to an order.\n\n:::note\n\n- Adding, modifying, or removing any cart items, custom items, or promotions always returns the cart meta, calculated using the calculation method. This is useful to update the client with up-to-date totals.\n- We will automatically delete carts 7 days after they were last updated.\n- If you do not pass a `X-MOLTIN-CURRENCY` header specifying what currency you would like the cart to use, the products in the cart are converted to your default currency.\n\n:::\n", "item": [ { "id": "ec57e718-4419-4c53-8f82-1517e7264e30", "name": "Get Carts", "request": { "name": "Get Carts", "description": { "content": "Retrieves a list of carts. The carts returned depend on the authentication method used:\n\n| Authentication Method | Header | Returns |\n| :--- | :--- | :--- |\n| **Customer Token** | `X-Moltin-Customer-Token` | Carts for the specified customer. See [Customer Tokens](/docs/customer-management/customer-management-api/customer-tokens). |\n| **Account Token** | `EP-Account-Management-Authentication-Token` | Carts for the specified account. See [Account Management Token](/docs/api/accounts/post-v-2-account-members-tokens). |\n| **Client Credentials** | `Authorization: Bearer ` | All carts or only registered carts, controlled by the `show_all_carts` setting. See [Cart Settings](/docs/api/carts/put-v-2-settings-cart). |\n\n**Client Credentials Behavior:**\n- When `show_all_carts` is `true`: Returns all carts in the store.\n- When `show_all_carts` is `false`: Returns only registered carts (associated with customers or accounts).\n\n**Sorting**\n\nCarts are sorted in descending order by `updated_date`. For more information, see [Pagination](/guides/Getting-Started/pagination).\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching carts. For more information about filtering, see [Filtering](/guides/Getting-Started/filtering).\n\n**Supported Fields:**\n- `account_ids`: Filter carts by associated account ID (UUID format)\n- `name`: Filter carts by cart name (case-insensitive)\n\n**Supported Operators:**\n- `contains(field,value)`: Contains value in array field\n- `ilike(field,value)`: Case-insensitive string matching\n\n**Examples:**\n- `contains(account_ids,\"c24e5698-3b54-491b-9225-559c7a9cf2b2\")` - Find carts associated with a specific account\n- `ilike(name,\"Shopping Cart\")` - Find carts with name matching \"Shopping Cart\" (case-insensitive)\n- `ilike(name,\"*cart*\")` - Find carts with names containing \"cart\" (wildcard search)\n\n**Combining Filters:**\nYou can combine multiple filters using the `:`, and `|` operator for and and or respectively:\n- `contains(account_ids,\"abc123\"):ilike(name,\"Holiday Cart\")` - Find carts matching both conditions\n- `contains(account_ids,\"abc123\")|ilike(name,\"Holiday Cart\")` - Find carts matching either condition.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cd0c22f3-d6f5-4645-8cb4-ad6fcc3a8a04", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching carts. For more information about filtering, see [Filtering](/guides/Getting-Started/filtering).\n\n**Supported Fields:**\n- `account_ids`: Filter carts by associated account ID (UUID format)\n- `name`: Filter carts by cart name (case-insensitive)\n\n**Supported Operators:**\n- `contains(field,value)`: Contains value in array field\n- `ilike(field,value)`: Case-insensitive string matching\n\n**Examples:**\n- `contains(account_ids,\"c24e5698-3b54-491b-9225-559c7a9cf2b2\")` - Find carts associated with a specific account\n- `ilike(name,\"Shopping Cart\")` - Find carts with name matching \"Shopping Cart\" (case-insensitive)\n- `ilike(name,\"*cart*\")` - Find carts with names containing \"cart\" (wildcard search)\n\n**Combining Filters:**\nYou can combine multiple filters using the `:`, and `|` operator for and and or respectively:\n- `contains(account_ids,\"abc123\"):ilike(name,\"Holiday Cart\")` - Find carts matching both conditions\n- `contains(account_ids,\"abc123\")|ilike(name,\"Holiday Cart\")` - Find carts matching either condition.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"9EQYAH-TCKAy@bWWTMkXrJCZFlLojW.jl\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": true,\n \"use_rule_promotions\": false\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": 1345.1522266146565\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 5458.155721153624\n },\n \"key_3\": {\n \"type\": \"boolean\",\n \"value\": false\n },\n \"key_4\": {\n \"type\": \"integer\",\n \"value\": 6401.045549170981\n }\n },\n \"snapshot_date\": \"2021-04-17T02:37:07.911Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1525.33057590859,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 4223.857300096348,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 7980.57406862342,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 6894.097511526511,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 9217.710116564966,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8774.980819172564,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 4616.700360223458,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 1424,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": 2752.13842668635\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8068,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 6958,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": \"string\"\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 80,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"0a6c0bc2-e7ed-a256-7e8c-14f9564a847e\"\n },\n {\n \"type\": \"string\",\n \"id\": \"cd5fb6d9-b6eb-fbe6-9bc6-38bad2c4282f\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"e8feb35f-4d55-6a43-e403-3ae8a001b73a\"\n },\n {\n \"type\": \"string\",\n \"id\": \"ab16e57c-9297-b059-aa01-f012a322ed23\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"50f91e10-8cf5-ab5b-65d8-773f768c04e7\"\n },\n {\n \"type\": \"string\",\n \"id\": \"bf1202de-d474-9248-d9a4-c092dbf7ea94\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"9631d600-8847-c06d-bfe5-47a4ab968c85\"\n },\n {\n \"type\": \"string\",\n \"id\": \"f01ebc1e-7779-3e60-1cb9-a52a4b84fef7\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"9be0dc1b-c873-9027-a34d-f219840b5a25\"\n },\n {\n \"type\": \"string\",\n \"id\": \"0f92bb3f-2dbf-f721-16b0-373f80e6f78a\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"zkB5p1@BjfeEVQMdNDCYiH.wpy\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": true,\n \"use_rule_promotions\": false\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": true\n },\n \"item_settings\": {\n \"separate_items_by_location\": true\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 100.02921496221617\n },\n \"key_1\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n }\n },\n \"snapshot_date\": \"1981-08-29T11:25:32.953Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2949.4103275986317,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 7772.063318342548,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 4639.504403482481,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 8759.592883825824,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 8518.483666699833,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 1876.3024143000218,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 2504.2973753624874,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 7512,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 9014,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2506,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 2290.8980436422844,\n \"key_1\": 7186.541507233142,\n \"key_2\": 900,\n \"key_3\": \"string\"\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8246,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2acebe18-823e-0306-fe1f-dcee869afafa\"\n },\n {\n \"type\": \"string\",\n \"id\": \"650b8672-05b5-05c2-67d3-36210bf8cbc8\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"6ab3038a-5706-1fda-a843-8d8def7f9a5f\"\n },\n {\n \"type\": \"string\",\n \"id\": \"918aded6-3903-00dd-1a4b-8da8319bc20d\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"314c579b-ae98-8f6b-ba17-efe4e73504b2\"\n },\n {\n \"type\": \"string\",\n \"id\": \"2580c4ee-890f-fad7-8feb-b949881797ff\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"ff812d9d-029e-a173-0ca3-c66d2b025ef0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"2ad24d12-ef81-156c-8ae8-9b3aba05b695\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"db5b2021-c5f2-092c-708a-216e562f8650\"\n },\n {\n \"type\": \"string\",\n \"id\": \"8ef329ef-86ba-f163-64ab-373fff6d30cb\"\n }\n ]\n }\n },\n \"type\": \"string\"\n }\n ],\n \"links\": {\n \"current\": \"string\",\n \"first\": \"string\",\n \"last\": \"string\",\n \"next\": \"string\",\n \"prev\": \"string\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 8128,\n \"limit\": 9586,\n \"offset\": 8596,\n \"total\": 2810\n },\n \"results\": {\n \"total\": 7287\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7eb9333-bfe3-4ae3-9196-8d48cf60742d", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching carts. For more information about filtering, see [Filtering](/guides/Getting-Started/filtering).\n\n**Supported Fields:**\n- `account_ids`: Filter carts by associated account ID (UUID format)\n- `name`: Filter carts by cart name (case-insensitive)\n\n**Supported Operators:**\n- `contains(field,value)`: Contains value in array field\n- `ilike(field,value)`: Case-insensitive string matching\n\n**Examples:**\n- `contains(account_ids,\"c24e5698-3b54-491b-9225-559c7a9cf2b2\")` - Find carts associated with a specific account\n- `ilike(name,\"Shopping Cart\")` - Find carts with name matching \"Shopping Cart\" (case-insensitive)\n- `ilike(name,\"*cart*\")` - Find carts with names containing \"cart\" (wildcard search)\n\n**Combining Filters:**\nYou can combine multiple filters using the `:`, and `|` operator for and and or respectively:\n- `contains(account_ids,\"abc123\"):ilike(name,\"Holiday Cart\")` - Find carts matching both conditions\n- `contains(account_ids,\"abc123\")|ilike(name,\"Holiday Cart\")` - Find carts matching either condition.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29dc24a5-5f21-4e71-ab7b-9ff3ed57c3d3", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching carts. For more information about filtering, see [Filtering](/guides/Getting-Started/filtering).\n\n**Supported Fields:**\n- `account_ids`: Filter carts by associated account ID (UUID format)\n- `name`: Filter carts by cart name (case-insensitive)\n\n**Supported Operators:**\n- `contains(field,value)`: Contains value in array field\n- `ilike(field,value)`: Case-insensitive string matching\n\n**Examples:**\n- `contains(account_ids,\"c24e5698-3b54-491b-9225-559c7a9cf2b2\")` - Find carts associated with a specific account\n- `ilike(name,\"Shopping Cart\")` - Find carts with name matching \"Shopping Cart\" (case-insensitive)\n- `ilike(name,\"*cart*\")` - Find carts with names containing \"cart\" (wildcard search)\n\n**Combining Filters:**\nYou can combine multiple filters using the `:`, and `|` operator for and and or respectively:\n- `contains(account_ids,\"abc123\"):ilike(name,\"Holiday Cart\")` - Find carts matching both conditions\n- `contains(account_ids,\"abc123\")|ilike(name,\"Holiday Cart\")` - Find carts matching either condition.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fda202b7-0773-438c-a869-f9d9d5df07e1", "name": "Create a Cart", "request": { "name": "Create a Cart", "description": { "content": "\nCreates a cart. Call this endpoint each time a customer creates a cart.\n\nEach shopper can have multiple carts. Use the carts API to create a cart. The carts are distinct from one another. Shoppers can add different items to their carts. They can check out one of the carts without affecting the content or status of their other carts.\n\nAfter the shopper checks out the cart, the cart remains available to the shopper. The cart is persistent and stays with the shopper after it is used.\n\nYou can create a cart to specify custom discounts. You can enable custom discounts when the `discount_settings.custom_discounts_enabled` field is set to `true`. Default is set from cart discount settings for the store. See [Update Cart Settings](/docs/api/carts/put-v-2-settings-cart).\n\nYou can also create a cart when inventory checks are not performed until checkout by setting the `inventory_settings.defer_inventory_check` field to `true`. Again the default is set from cart discount settings for the store. See [Update Cart Settings](/docs/api/carts/put-v-2-settings-cart).\n\n### Preview Cart\n\nYou can set a future date for your shopping cart and view the promotions that will be available during that time period. This feature enables you to validate your promotion settings and observe how they will be applied in the cart.\n\n:::caution\n- Once the cart is in preview mode, you cannot revert it to a regular cart.\n- Carts with `snapshot_date` are same as preview carts.\n- You cannot checkout a cart that includes a `snapshot_date`.\n- To delete a promotion preview cart, use [Delete a cart](/docs/api/carts/delete-a-cart) endpoint.\n- The promotion preview cart has the same expiration time as a regular cart based on the store's [cart settings](/docs/api/carts/put-v-2-settings-cart).\n- Preview cart interactions skip inventory checks and events, allowing users to preview future carts without impacting related external systems.\n:::\n\n### Custom Attributes\nYou can create custom attributes for the cart object to include additional information, enabling promotions that target specific cart attributes.\nFor example:\n```\n\"custom_attributes\":{\n \"membership\": {\n \"type\": \"string\",\n \"value\": \"VIP\"\n }\n}\n```\nSee [adding cart custom attributes in promotions builder](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#adding-cart-custom-attributes)\n\nCart custom attributes remain with the corresponding cart for the extent of its lifecycle. These custom attributes carry over to the resulting order objects on checkout and those on carts are deleted with their carts upon cart deletions.\nCustom attributes can be updated or removed using a PUT request. To delete specific custom attributes, simply exclude the unwanted attribute objects from the PUT request body.\n\n### Contact Email\nYou can attach an email to carts via the `contact.email` field. These values help identify guest shopper carts and, in the case of promotions with maximum usage settings for guest and registered shopper, track per-shopper promotion usages.\nSee [Create Max Uses Per Shopper Promotion Codes](/docs/promotions-builder/promotions-builder-codes/create-max-use-limit-promotion-codes)\n\nFor example:\n```\n\"contact\": {\n \"email\": \"tester@email.com\"\n}\n```\n\nPlease note, this value is not supported for registered shopper carts (that is, carts with accounts or customers associated), as these carts already have email values associated via the shopper details. Accordingly, requests to add contact email information to registered shopper carts (and vice versa) result in error messages.\n\n### Errors\n\n- `400 Bad Request` : This is returned when the submitted request does not adhere to the expected API contract for the endpoint.\n\n - For example, in the case of string fields, this error might indicate issues in the length or format of submitted strings. For more information about valid string fields, refer to Safe Characters section.\n - In the case of preview carts (those with `snapshot_date`), an error is returned for invalid actions, such as removing the preview date, setting a preview date in the past, or attempting to checkout a cart with a `snapshot_date`.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token for the account to be associated with the cart.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token for the customer to be associated with the cart.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Bob's cart\",\n \"description\": \"For Holidays\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c3d4b416-7ec1-4934-8d4f-e6fa3b63bd34", "name": "201", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token for the account to be associated with the cart.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token for the customer to be associated with the cart.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Bob's cart\",\n \"description\": \"For Holidays\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"BYW@fvtPQHikMlhvFheliuFLuqyQXLFPeXcB.mt\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": 822.6772421098926\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 126.79575312376734\n }\n },\n \"snapshot_date\": \"1984-05-06T14:31:35.698Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7724.690250418494,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 965.6893846416992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9240.72236121114,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 188.6342658542728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 4122.139928207081,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8153.970412608016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 8167.249846653129,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2122,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 1393.0676428419474,\n \"key_1\": 5865,\n \"key_2\": false\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 2964,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 6458,\n \"key_3\": 9043.797956152996\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4626,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\"\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 955,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"57c7ca77-1c04-de46-8283-92537a5691fb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"03cbbace-aba2-d8fe-25b8-0cb4e786d75a\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"cb813261-ffc1-6204-012e-55cc805858fe\"\n },\n {\n \"type\": \"string\",\n \"id\": \"07a16b25-827c-ba50-0486-c7de1457ae77\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7e8a5c67-b7b2-6d1d-81ab-d4af345edff0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"54f4444f-9f2b-c23d-cb0d-037e11213487\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2bb549af-f621-257f-f762-46f4d8d8286b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"6b5cfc90-a884-4bf5-eee9-7ff40bb0efcc\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"3254f8bd-e55f-3d7e-a366-007cbd64bc6b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"e1272995-876e-86b5-5724-9856596ffdee\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"6f41b966-482a-3900-d8ec-2fdcef590adf\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 6175.651459105089,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"599189db-6f15-3977-ec51-8fb379d98eff\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"0d0ac6bf-1a9e-6244-5021-e01c8de37428\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 703.8131625745225,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"8713c39d-7f57-534b-8451-6d15fff0667e\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"7d28230f-b33c-99b1-0427-67677ee6f2e6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1977-10-28T16:57:46.835Z\",\n \"end\": \"1994-11-29T00:54:35.861Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"a54245b5-921a-05b3-ea7d-c6a36c072882\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2005-03-24T22:56:18.880Z\",\n \"end\": \"1976-08-30T19:13:41.495Z\"\n }\n ]\n },\n \"meta\": {\n \"payment_intent\": {\n \"key_0\": \"string\"\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"9jC5C@kYJCTLLKKXzXfEvkHoyh.ytaf\",\n \"component_product_id\": \"4f414aa9-0189-8467-15f8-839642991de7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 7590,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"hcA@vcvu.dulp\",\n \"component_product_id\": \"5f7524f1-86a7-57ab-1ae4-c6483195beea\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0bcd3f1-7b72-44e7-a61b-a810aec79fca", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token for the account to be associated with the cart.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token for the customer to be associated with the cart.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Bob's cart\",\n \"description\": \"For Holidays\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79548ad0-459e-424e-bafb-b4547514361d", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token for the account to be associated with the cart.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "disabled": false, "description": { "content": "A customer token for the customer to be associated with the cart.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Bob's cart\",\n \"description\": \"For Holidays\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "25c0df0b-97c3-486c-9cd0-89af72187eaf", "name": "Get a Cart", "request": { "name": "Get a Cart", "description": { "content": "Use this endpoint to retrieve a specific cart. If a cart ID does not exist, a new cart will be automatically created. If the cart is associated with shipping groups, calling this endpoint displays the associated shipping group IDs in the `relationships` section.\n\nYou can easily get a new or existing cart by providing the unique cart reference in the request. If the cart is associated with shipping groups, calling this endpoint displays the associated shipping group IDs in the relationships section.\n\n:::note\n\n- The default cart name is Cart. However, you can update the cart name as required. Ensure that the string length of the name is greater than or equal to one. Follow the safe character guidelines for name and description naming. For more information about cart ID naming requirements, see the [Safe Characters](/guides/Getting-Started/safe-characters) section.\n- Outside of the JS-SDK, we don't handle creating cart references. You need to create your own.\n\n:::\n\n:::caution\n\nAn empty cart is returned for any carts that don't currently exist. For more information about the cart items object, see [Get Cart Items](/docs/api/carts/get-cart-items).\n\n:::\n\n### Query parameters\n\n\n| Name | Required | Type | Description |\n|:----------|:---------|:---------|:-------------------------------------------|\n| `include` | Optional | `string` | Comma-delimited string of entities that can be included. The information included are `items`,`tax_items`, `custom_discounts`, or `promotions`. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" } ], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier for this cart that you created.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ed593071-954f-429d-b9a4-a6cdee98bba2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for this cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"BYW@fvtPQHikMlhvFheliuFLuqyQXLFPeXcB.mt\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": 822.6772421098926\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 126.79575312376734\n }\n },\n \"snapshot_date\": \"1984-05-06T14:31:35.698Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7724.690250418494,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 965.6893846416992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9240.72236121114,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 188.6342658542728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 4122.139928207081,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8153.970412608016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 8167.249846653129,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2122,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 1393.0676428419474,\n \"key_1\": 5865,\n \"key_2\": false\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 2964,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 6458,\n \"key_3\": 9043.797956152996\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4626,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\"\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 955,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"57c7ca77-1c04-de46-8283-92537a5691fb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"03cbbace-aba2-d8fe-25b8-0cb4e786d75a\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"cb813261-ffc1-6204-012e-55cc805858fe\"\n },\n {\n \"type\": \"string\",\n \"id\": \"07a16b25-827c-ba50-0486-c7de1457ae77\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7e8a5c67-b7b2-6d1d-81ab-d4af345edff0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"54f4444f-9f2b-c23d-cb0d-037e11213487\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2bb549af-f621-257f-f762-46f4d8d8286b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"6b5cfc90-a884-4bf5-eee9-7ff40bb0efcc\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"3254f8bd-e55f-3d7e-a366-007cbd64bc6b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"e1272995-876e-86b5-5724-9856596ffdee\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"6f41b966-482a-3900-d8ec-2fdcef590adf\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 6175.651459105089,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"599189db-6f15-3977-ec51-8fb379d98eff\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"0d0ac6bf-1a9e-6244-5021-e01c8de37428\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 703.8131625745225,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"8713c39d-7f57-534b-8451-6d15fff0667e\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"7d28230f-b33c-99b1-0427-67677ee6f2e6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1977-10-28T16:57:46.835Z\",\n \"end\": \"1994-11-29T00:54:35.861Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"a54245b5-921a-05b3-ea7d-c6a36c072882\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2005-03-24T22:56:18.880Z\",\n \"end\": \"1976-08-30T19:13:41.495Z\"\n }\n ]\n },\n \"meta\": {\n \"payment_intent\": {\n \"key_0\": \"string\"\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"9jC5C@kYJCTLLKKXzXfEvkHoyh.ytaf\",\n \"component_product_id\": \"4f414aa9-0189-8467-15f8-839642991de7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 7590,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"hcA@vcvu.dulp\",\n \"component_product_id\": \"5f7524f1-86a7-57ab-1ae4-c6483195beea\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c85b932-55d7-4764-9994-0ca7965d6e05", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "custom_discounts" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for this cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "de15aaaa-db46-4fdb-91ef-4267def4cb52", "name": "Update a Cart", "request": { "name": "Update a Cart", "description": { "content": "Updates cart properties for the specified cartID.\n\nYou can update a cart to specify custom discounts. You can enable custom discounts when the `discount_settings.custom_discounts_enabled` field is set to `true`. Default is set from cart discount settings for the store. See [Cart Settings](/docs/api/carts/put-v-2-settings-cart).\n\nYou can also create a cart when inventory checks are not performed until checkout by setting the `inventory_settings.defer_inventory_check` field to `true`. Again the default is set from cart discount settings for the store. See [Update Cart Settings](/docs/api/carts/put-v-2-settings-cart).\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of a cart created by you.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"my cart\",\n \"description\": \"my first cart\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"snapshot_date\": \"2026-09-10T00:12:00Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d9badb30-1263-455f-bea0-d6d5c5bcfc55", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"my cart\",\n \"description\": \"my first cart\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"snapshot_date\": \"2026-09-10T00:12:00Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"BYW@fvtPQHikMlhvFheliuFLuqyQXLFPeXcB.mt\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": 822.6772421098926\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 126.79575312376734\n }\n },\n \"snapshot_date\": \"1984-05-06T14:31:35.698Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7724.690250418494,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 965.6893846416992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9240.72236121114,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 188.6342658542728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 4122.139928207081,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8153.970412608016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 8167.249846653129,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2122,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 1393.0676428419474,\n \"key_1\": 5865,\n \"key_2\": false\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 2964,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 6458,\n \"key_3\": 9043.797956152996\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4626,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\"\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 955,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"57c7ca77-1c04-de46-8283-92537a5691fb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"03cbbace-aba2-d8fe-25b8-0cb4e786d75a\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"cb813261-ffc1-6204-012e-55cc805858fe\"\n },\n {\n \"type\": \"string\",\n \"id\": \"07a16b25-827c-ba50-0486-c7de1457ae77\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7e8a5c67-b7b2-6d1d-81ab-d4af345edff0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"54f4444f-9f2b-c23d-cb0d-037e11213487\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2bb549af-f621-257f-f762-46f4d8d8286b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"6b5cfc90-a884-4bf5-eee9-7ff40bb0efcc\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"3254f8bd-e55f-3d7e-a366-007cbd64bc6b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"e1272995-876e-86b5-5724-9856596ffdee\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"6f41b966-482a-3900-d8ec-2fdcef590adf\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 6175.651459105089,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"599189db-6f15-3977-ec51-8fb379d98eff\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"0d0ac6bf-1a9e-6244-5021-e01c8de37428\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 703.8131625745225,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"8713c39d-7f57-534b-8451-6d15fff0667e\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"7d28230f-b33c-99b1-0427-67677ee6f2e6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1977-10-28T16:57:46.835Z\",\n \"end\": \"1994-11-29T00:54:35.861Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"a54245b5-921a-05b3-ea7d-c6a36c072882\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2005-03-24T22:56:18.880Z\",\n \"end\": \"1976-08-30T19:13:41.495Z\"\n }\n ]\n },\n \"meta\": {\n \"payment_intent\": {\n \"key_0\": \"string\"\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"9jC5C@kYJCTLLKKXzXfEvkHoyh.ytaf\",\n \"component_product_id\": \"4f414aa9-0189-8467-15f8-839642991de7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 7590,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"hcA@vcvu.dulp\",\n \"component_product_id\": \"5f7524f1-86a7-57ab-1ae4-c6483195beea\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e822fd1-8fda-481f-90ae-b4d76f5359cc", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"my cart\",\n \"description\": \"my first cart\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"snapshot_date\": \"2026-09-10T00:12:00Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d2a9f90-1e7b-4a18-b5b2-1e43e3b963d9", "name": "Unprocessable Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"my cart\",\n \"description\": \"my first cart\",\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"snapshot_date\": \"2026-09-10T00:12:00Z\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"UW2XfJ5jJ5q@IFnWPAGrppJWqUq.lyf\",\n \"component_product_id\": \"e1078eae-046d-e926-ec3e-171d53395644\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "629e6ad8-369a-4d84-b187-7ddbb27cec7c", "name": "Delete a Cart", "request": { "name": "Delete a Cart", "description": { "content": "You can delete a cart, including the items, name, description, and remove all associations.\n\n### Errors\n\nThe following error message is received when you attempt to delete a cart that is associated with a customer. Before deletion, ensure that the cart is disassociated.\n\n```json\nmessage: {\n errors: [\n {\n status: 400,\n title: 'Last cart',\n detail: 'This is the last cart associated with a customer and it cannot be deleted, try disassociating instead'\n }\n ]\n }\n````\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "aa4e9adf-42f5-4c91-9e41-07f9c95889ba", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "46ecf003-b822-492b-900e-9daa6c008ca7", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account Cart Associations", "description": "You can create associations between an account and one or more carts. After cart associations exist for an account, those carts are accessible across any device. You can delete associations as required.\n\nThere are two ways to access the cart: with an [Account Management Authentication Tokens](/docs/api/accounts/post-v-2-account-members-tokens) and without one.\n\n### With an `Account Management Authentication` token\n\nThese endpoints are for users who authenticated implicitly and require an Account Management Authentication token in the header to access the account cart associations APIs. For more information, see the [Account Token](/docs/api/accounts/post-v-2-account-members-tokens) documentation.\n\n#### Cart creation\n\nShoppers create carts and can use any of the carts that they created to check out an order.\n\n:::note\n\nYou can create a cart id, name, and description for the cart. The cart requires a name. Ensure that the string length is greater than or equal to one. Use any symbol in the name and description. For cart id, ensure that you follow the guidelines for safe characters. For more information about cart id naming requirements, see [Safe Characters](/guides/Getting-Started/safe-characters).\n\n:::\n\n### Without an `Account Management Authentication` token\n\nThese endpoints are for users who use the Client Credentials Token and do not require an account management authentication token in the header to access the account cart associations APIs. For more information, see the [Authentication](/docs/authentication/security) documentation.\n\nThis user acts as a system administrator and can call any account cart association operations for any account and cart.\n\n### Error Codes\n\nYou might encounter the following response codes, depending on the scenario:\n\n* `400` - `The type does not exist or is not listed as account` - Ensure that the type is `account` and is present.\n\n* `403` - `Cannot associate more than one account`.\n\n* `403` - `Account does not have the required permissions to fulfill this request`.\n\n* `403` - `Invalid json payload` - Check JSON input. The request body must be an array `[]`. If the request body is an object, the error is generated.\n", "item": [ { "id": "cae626fc-f5d6-4072-8357-99b2e12168e8", "name": "Create an Account Cart Association", "request": { "name": "Create an Account Cart Association", "description": { "content": "You can create associations between an account and one or more carts. After cart associations exist for an account, the account can access those carts across any device.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dee2a9e9-e3fb-4a6e-9481-9dafb4443957", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "253e477b-ca3a-44b4-bc55-49a8f5f3b331", "name": "No Content is sent back in case the account has already been associated to the cart.", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ec2b3dad-06db-49cd-813e-1862173e5628", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa6bd87e-65a4-45f5-9acd-c6c777dd1f62", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ff26458-bcb1-4e29-b7b3-4a0aa1434b81", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Unable to associate accounts to carts with contact emails attached.\",\n \"status\": 400,\n \"title\": \"Cannot associate accounts to carts with contact emails\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f6213dbc-309d-4820-93b6-256730c96df7", "name": "Delete Account Cart Association", "request": { "name": "Delete Account Cart Association", "description": { "content": "You can delete an association between an account and a cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a24c575a-83f9-4a14-a659-c35ab14b736d", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "53035718-c6be-46ed-9370-b0233fd93bc9", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d73e8448-19dd-4fc8-badf-34dce9b98100", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the account.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An Account Management Authentication token to access a specific account's carts.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Customer Cart Associations", "description": "You can create associations between a customer and one or more carts. After cart associations exist for a customer, those carts are accessible across any device. You can delete associations as required.\n\nThere are two ways to access the cart: with a customer token and without one.\n\n### With a `customer` token\n\nThese endpoints are for users who authenticated implicitly and require a customer token in the header to access the customer cart associations APIs. For more information, see the [Customer Token](/docs/customer-management/customer-management-api/customer-tokens) documentation.\n\n#### Cart creation\n\nShoppers create carts and can use any of the carts that they created to check out an order.\n\n:::note\n\nYou can create a cart id, name, and description for the cart. The cart requires a name. Ensure that the string length is greater than or equal to one. Use any symbol in the name and description. For cart id, ensure that you follow the guidelines for safe characters. For more information about cart id naming requirements, see [Safe Characters](/guides/Getting-Started/safe-characters).\n\n:::\n\n### Without a `customer` token\n\nThese endpoints are for users who use the Client Credentials Token and do not require a Customer token in the header to access the customer cart associations APIs. For more information, see the [Authentication](/docs/authentication/security) documentation.\n\nThis user acts as a system administrator and can call any customer cart association operations for any customer and cart.\n\n### Error Codes\n\nYou might encounter the following response codes, depending on the scenario:\n\n* `400` - `The type does not exist or is not listed as customer` - Ensure that the type is `customer` and is present.\n\n* `403` - `Cannot associate more than one customer`.\n\n* `403` - `Customer does not have the required permissions to fulfill this request`.\n\n* `403` - `Invalid json payload` - Check JSON input. The request body must be an array `[]`. If the request body is an object, the error is generated.\n", "item": [ { "id": "0a8930a3-441f-4409-8a71-38e6eb236fda", "name": "Create a Customer Cart Association", "request": { "name": "Create a Customer Cart Association", "description": { "content": "You can create associations between a customer and one or more carts. After cart associations exist for a customer, the customer can access those carts across any device.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "68e3518f-b441-4162-aa80-dce83e1f7c16", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1903c0f3-01bf-44f7-8b33-24fdb8932923", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "af547c4c-7794-44a5-8e7f-68110edd2efd", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b76df66a-a958-418e-a461-5312ccb89361", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69dcfc36-52c5-4e10-9437-5e176c13e94b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters).", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Unable to associate customers to carts with contact emails attached.\",\n \"status\": 400,\n \"title\": \"Cannot associate customers to carts with contact emails\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "528d973a-a584-4be9-ad7b-e2cf709d7af9", "name": "Delete Customer Cart Association", "request": { "name": "Delete Customer Cart Association", "description": { "content": "You can delete an association between a customer and a cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a00480f7-6115-40fb-b2ed-863a5df0194e", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9a236603-c1fc-4fe6-bbd4-86afdc1c3790", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9281aa9b-0a41-4ff3-a31e-b7b6f7eb0c84", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "relationships", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the cart created by the customer.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's carts.", "type": "text/plain" }, "key": "X-Moltin-Customer-Token", "value": "{{customerToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"type\": \"string\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Cart Items", "description": "Products added to a cart are referred to as a `cart_item`.", "item": [ { "id": "8b838105-ff46-41de-a850-6a5acfd1fc57", "name": "Get Cart Items", "request": { "name": "Get Cart Items", "description": { "content": "\nUse this endpoint to retrieve cart items. If the cart is associated with shipping groups, calling this endpoint displays the associated shipping group IDs.\n\nYou can use this endpoint to retrieve the breakdown of cart items by promotion ID. For example, if you have Promotions Standard item discount with code *sale2024*, Rule Promotions item discount with code *sale2024*, and Rule Promotions cart discount with code *sale2024*, the `discounts.constituents` field in the response example will show the breakdown of the same promotion code used in both Promotions Standard and Rule Promotions.\n\n```json\n\"data\": [\n{\n \"id\": \"98de010d-dd10-4fa5-a070-0b9bcdc72974\",\n \"type\": \"cart_item\",\n \"product_id\": \"5a4662d2-9a2b-4f6e-a215-2970db914b0c\",\n \"name\": \"sku1\",\n \"description\": \"sku1\",\n \"sku\": \"sku1\",\n \"slug\": \"sku1\",\n \"image\": {\n \"mime_type\": \"\",\n \"file_name\": \"\",\n \"href\": \"\"\n },\n \"quantity\": 1,\n \"manage_stock\": false,\n \"unit_price\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": -2000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"code\": \"sale2024\",\n \"id\": \"e4d929d5-f471-4317-9a86-a84a6c572b44\",\n \"promotion_source\": \"rule-promotion\",\n \"is_cart_discount\": true\n },\n {\n \"amount\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"code\": \"sale2024\",\n \"id\": \"de19a043-a6da-4bde-b896-d17e16b77e25\",\n \"promotion_source\": \"rule-promotion\"\n },\n {\n \"amount\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"code\": \"sale2024\",\n \"id\": \"509295ee-2971-45b6-801e-95df09756989\"\n },\n {\n \"amount\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"code\": \"sale2024\",\n \"id\": \"ca79e606-7ecd-41ac-9478-af4c8c28c546\",\n \"promotion_source\": \"rule-promotion\",\n \"is_cart_discount\": true\n }\n ],\n \"links\": {\n \"product\": \"https://useast.api.elasticpath.com/v2/products/5a4662d2-9a2b-4f6e-a215-2970db914b0c\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 5000,\n \"currency\": \"USD\",\n \"formatted\": \"$50.00\"\n },\n \"value\": {\n \"amount\": 5000,\n \"currency\": \"USD\",\n \"formatted\": \"$50.00\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 5000,\n \"currency\": \"USD\",\n \"formatted\": \"$50.00\"\n },\n \"value\": {\n \"amount\": 5000,\n \"currency\": \"USD\",\n \"formatted\": \"$50.00\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": -5000,\n \"currency\": \"USD\",\n \"formatted\": \"-$50.00\"\n },\n \"value\": {\n \"amount\": -5000,\n \"currency\": \"USD\",\n \"formatted\": \"-$50.00\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"formatted\": \"$100.00\"\n },\n \"value\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"formatted\": \"$100.00\"\n }\n },\n \"discounts\": {\n \"sale2024\": {\n \"amount\": -5000,\n \"currency\": \"USD\",\n \"formatted\": \"-$50.00\",\n \"constituents\": {\n \"509295ee-2971-45b6-801e-95df09756989\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"ca79e606-7ecd-41ac-9478-af4c8c28c546\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"de19a043-a6da-4bde-b896-d17e16b77e25\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"e4d929d5-f471-4317-9a86-a84a6c572b44\": {\n \"amount\": -2000,\n \"currency\": \"USD\",\n \"formatted\": \"-$20.00\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"2024-05-24T18:00:58Z\",\n \"updated_at\": \"2024-05-24T18:00:58Z\"\n }\n },\n \"catalog_id\": \"09b9359f-897f-407f-89a2-702e167fe781\",\n \"catalog_source\": \"pim\"\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "A comma-separated list of related resources to include in the response.", "type": "text/plain" }, "key": "include", "value": "promotions,promotions" } ], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "519021fb-a329-4980-bd13-0d050d84e349", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "A comma-separated list of related resources to include in the response.", "type": "text/plain" }, "key": "include", "value": "promotions,promotions" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"06a9dd8d-ccbc-b0b0-3821-9ac2395e342a\",\n \"type\": \"subscription_item\",\n \"product_id\": \"5f9f82d4-a486-800b-9708-3b6c7f5f1f37\",\n \"promotion_id\": \"8c891fc0-8b50-84bf-f4ed-2f1c33e5c6d9\",\n \"subscription_offering_id\": \"8252de70-39b1-b9ac-3bb5-b4a1f7e41e14\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"6f016736-b09c-8b71-15c9-e413ac716ebf\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 3389.0001901081823\n },\n \"key_1\": {\n \"key_0\": 5525.62499871051,\n \"key_1\": 5811.885765457368\n },\n \"key_2\": {\n \"key_0\": 96.58028073439739,\n \"key_1\": 4855.554349360263\n },\n \"key_3\": {\n \"key_0\": 7617.083210233202\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 2892.1939672159237,\n \"key_1\": 4786,\n \"key_2\": 6937.164260253446\n },\n \"meta\": {\n \"key_0\": 4865.2362346038935,\n \"key_1\": 7175.606854753931\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 699\n },\n \"relationships\": {\n \"key_0\": 9263\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": 5507\n },\n \"meta\": {\n \"key_0\": 6453.324771515027,\n \"key_1\": 3937.5248294054945,\n \"key_2\": 4578.81636042607\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 9095,\n \"key_2\": \"string\"\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7029.712197194455,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5449.879327912242,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 2253.682922182023,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 8264.315917715563,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 3072,\n \"auto_add_quantity\": 3058,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 887.6700414430561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 1694.5029349416395,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2747,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9150\n },\n {\n \"amount\": {\n \"amount\": 6048,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 5812\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 5955,\n \"key_1\": 733,\n \"key_2\": 236\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 1751.3234408257206,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4564.125175591392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 6056.953665708626,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5136.403054601157,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 9576.776958099961,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2828.515083273393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4473.471673719123,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 1818.9950118407894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 8701.47077503657,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9670.318262600964,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 4270.02164136627,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 3371.949000973784,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 3486,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5895.567765203525,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 4782.185844269602\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": \"string\"\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 2918.89603226005\n },\n \"key_3\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n }\n },\n {\n \"id\": \"780d700f-9e1f-089d-e670-c4e9d1b8bbad\",\n \"type\": \"cart_item\",\n \"product_id\": \"f0040996-173e-ad02-701b-9513b5227b0f\",\n \"promotion_id\": \"27ce6dc5-52f1-d0b3-3d6c-1884e0e1d8e3\",\n \"subscription_offering_id\": \"c40c5fb3-2a53-87db-184a-e1475ae3f351\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"1ba2ae21-4132-ca6f-e998-293f2151dd7a\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 8802.079264829716,\n \"key_1\": 102.60758189666097\n },\n \"key_1\": {\n \"key_0\": 7764.539374460695,\n \"key_1\": 3831.859127151165\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": false,\n \"key_1\": 6303.563953599187\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 5534.192793241304\n },\n \"relationships\": {\n \"key_0\": 3085,\n \"key_1\": 6703\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 1727.6049731968458\n },\n \"price\": {\n \"key_0\": \"string\"\n },\n \"relationships\": {\n \"key_0\": 7809.292540608337,\n \"key_1\": 8768.606062758225,\n \"key_2\": 4309.465678744508\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3493.8003798956906,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5858.539264830433,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 6522.075700622907,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 4443.4647542588455,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 7101,\n \"auto_add_quantity\": 6626,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 7845.317782972898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 7673.560783059126,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 4798,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 1275\n },\n {\n \"amount\": {\n \"amount\": 13,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 38\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 8640,\n \"key_1\": 8026.152604440926,\n \"key_2\": false\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 3848.021571349649,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 98.79277502554906,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8783.221410209395,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 218.76390597248997,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5515.707667289902,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7631.631635687106,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4574.392993375609,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6542.06596979878,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 429.434750081088,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6963.921964561122,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 2765.234173584994,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4837.964154727596,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 8094,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7816.611873300827,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 6928.8976954392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 2050,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 1598.7136035679384,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n }\n }\n }\n ],\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"887664f4-89cb-b973-c918-70f4a4fae0cb\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 1398.6853966216195,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7b6ba392-b9ff-4feb-ee9a-9a32f91b83b8\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"b2f668ca-c21e-ff63-aa70-5601d4971d9d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2954.0762137677048,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"d0fb3df7-5272-d75d-5112-c7a64ee6b61a\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1958-08-26T04:31:45.983Z\",\n \"id\": \"b405501f-f6d2-69ae-ca33-1718e031421a\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2008-08-09T01:11:17.886Z\",\n \"type\": \"string\"\n },\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1970-03-23T03:25:05.769Z\",\n \"id\": \"b2c3a9b0-4222-874d-e080-5accab190de9\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1960-09-27T16:06:57.505Z\",\n \"type\": \"string\"\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"241b88d7-80e8-e616-5aa5-f89860b5071d\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 3715.0423959626623,\n \"amount\": 2467\n },\n {\n \"type\": \"string\",\n \"id\": \"b5414547-4127-5f6a-b552-ed31cb7e205c\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 9110.43708142179,\n \"amount\": 4217\n }\n ]\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7069.468292199174,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 4544.84380566857,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 5496.914602478389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 39.41110038222728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 5313.856506253922,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2931.0042227437248,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 3668.020900024402,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 4741.445612019866,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 862.3112963780022,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 8648.309098615095,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"messages\": [\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n },\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n }\n ],\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7853,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8834,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 1383,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 4614,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7514,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4116,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 2162,\n \"key_1\": 9507\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 5380,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 3635,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 2078,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"yQvpu@jdPITBmPYvIHHKgqkZneVlaFmCpNm.xr\",\n \"component_product_id\": \"7368ad1b-6a14-8bfe-e7f4-cfd7879b6ef3\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"kL949RnRo@WrWg.noq\",\n \"component_product_id\": \"ab8f6974-b169-a70a-fbe5-2c4e97ded39f\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a190fcae-fda1-48bf-8b8d-8dfc3f3a468b", "name": "Bulk Update Items in Cart", "request": { "name": "Bulk Update Items in Cart", "description": { "content": "The bulk update feature allows shoppers to update an array of items to their cart in one action, rather than updating each item one at a time. Shoppers can update quantity and shipping group details in bulk requests. This minimizes the time for shoppers while updating items to their cart. Shoppers can even update multiple items with the same or different shipping groups to their cart.\n\nWhen you update multiple items that qualify for free gifts in the cart, the corresponding free gifts for all eligible products are also automatically updated in the cart.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "71e569ad-0714-4d42-a107-e6275468e7e3", "name": "Successfully updated cart items", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"06a9dd8d-ccbc-b0b0-3821-9ac2395e342a\",\n \"type\": \"subscription_item\",\n \"product_id\": \"5f9f82d4-a486-800b-9708-3b6c7f5f1f37\",\n \"promotion_id\": \"8c891fc0-8b50-84bf-f4ed-2f1c33e5c6d9\",\n \"subscription_offering_id\": \"8252de70-39b1-b9ac-3bb5-b4a1f7e41e14\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"6f016736-b09c-8b71-15c9-e413ac716ebf\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 3389.0001901081823\n },\n \"key_1\": {\n \"key_0\": 5525.62499871051,\n \"key_1\": 5811.885765457368\n },\n \"key_2\": {\n \"key_0\": 96.58028073439739,\n \"key_1\": 4855.554349360263\n },\n \"key_3\": {\n \"key_0\": 7617.083210233202\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 2892.1939672159237,\n \"key_1\": 4786,\n \"key_2\": 6937.164260253446\n },\n \"meta\": {\n \"key_0\": 4865.2362346038935,\n \"key_1\": 7175.606854753931\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 699\n },\n \"relationships\": {\n \"key_0\": 9263\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": 5507\n },\n \"meta\": {\n \"key_0\": 6453.324771515027,\n \"key_1\": 3937.5248294054945,\n \"key_2\": 4578.81636042607\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 9095,\n \"key_2\": \"string\"\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7029.712197194455,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5449.879327912242,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 2253.682922182023,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 8264.315917715563,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 3072,\n \"auto_add_quantity\": 3058,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 887.6700414430561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 1694.5029349416395,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2747,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9150\n },\n {\n \"amount\": {\n \"amount\": 6048,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 5812\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 5955,\n \"key_1\": 733,\n \"key_2\": 236\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 1751.3234408257206,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4564.125175591392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 6056.953665708626,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5136.403054601157,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 9576.776958099961,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2828.515083273393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4473.471673719123,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 1818.9950118407894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 8701.47077503657,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9670.318262600964,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 4270.02164136627,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 3371.949000973784,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 3486,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5895.567765203525,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 4782.185844269602\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": \"string\"\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 2918.89603226005\n },\n \"key_3\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n }\n },\n {\n \"id\": \"780d700f-9e1f-089d-e670-c4e9d1b8bbad\",\n \"type\": \"cart_item\",\n \"product_id\": \"f0040996-173e-ad02-701b-9513b5227b0f\",\n \"promotion_id\": \"27ce6dc5-52f1-d0b3-3d6c-1884e0e1d8e3\",\n \"subscription_offering_id\": \"c40c5fb3-2a53-87db-184a-e1475ae3f351\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"1ba2ae21-4132-ca6f-e998-293f2151dd7a\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 8802.079264829716,\n \"key_1\": 102.60758189666097\n },\n \"key_1\": {\n \"key_0\": 7764.539374460695,\n \"key_1\": 3831.859127151165\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": false,\n \"key_1\": 6303.563953599187\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 5534.192793241304\n },\n \"relationships\": {\n \"key_0\": 3085,\n \"key_1\": 6703\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 1727.6049731968458\n },\n \"price\": {\n \"key_0\": \"string\"\n },\n \"relationships\": {\n \"key_0\": 7809.292540608337,\n \"key_1\": 8768.606062758225,\n \"key_2\": 4309.465678744508\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3493.8003798956906,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5858.539264830433,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 6522.075700622907,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 4443.4647542588455,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 7101,\n \"auto_add_quantity\": 6626,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 7845.317782972898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 7673.560783059126,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 4798,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 1275\n },\n {\n \"amount\": {\n \"amount\": 13,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 38\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 8640,\n \"key_1\": 8026.152604440926,\n \"key_2\": false\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 3848.021571349649,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 98.79277502554906,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8783.221410209395,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 218.76390597248997,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5515.707667289902,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7631.631635687106,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4574.392993375609,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6542.06596979878,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 429.434750081088,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6963.921964561122,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 2765.234173584994,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4837.964154727596,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 8094,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7816.611873300827,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 6928.8976954392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 2050,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 1598.7136035679384,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n }\n }\n }\n ],\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"887664f4-89cb-b973-c918-70f4a4fae0cb\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 1398.6853966216195,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7b6ba392-b9ff-4feb-ee9a-9a32f91b83b8\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"b2f668ca-c21e-ff63-aa70-5601d4971d9d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2954.0762137677048,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"d0fb3df7-5272-d75d-5112-c7a64ee6b61a\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1958-08-26T04:31:45.983Z\",\n \"id\": \"b405501f-f6d2-69ae-ca33-1718e031421a\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2008-08-09T01:11:17.886Z\",\n \"type\": \"string\"\n },\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1970-03-23T03:25:05.769Z\",\n \"id\": \"b2c3a9b0-4222-874d-e080-5accab190de9\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1960-09-27T16:06:57.505Z\",\n \"type\": \"string\"\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"241b88d7-80e8-e616-5aa5-f89860b5071d\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 3715.0423959626623,\n \"amount\": 2467\n },\n {\n \"type\": \"string\",\n \"id\": \"b5414547-4127-5f6a-b552-ed31cb7e205c\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 9110.43708142179,\n \"amount\": 4217\n }\n ]\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7069.468292199174,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 4544.84380566857,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 5496.914602478389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 39.41110038222728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 5313.856506253922,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2931.0042227437248,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 3668.020900024402,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 4741.445612019866,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 862.3112963780022,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 8648.309098615095,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"messages\": [\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n },\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n }\n ],\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7853,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8834,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 1383,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 4614,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7514,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4116,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 2162,\n \"key_1\": 9507\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 5380,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 3635,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 2078,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"yQvpu@jdPITBmPYvIHHKgqkZneVlaFmCpNm.xr\",\n \"component_product_id\": \"7368ad1b-6a14-8bfe-e7f4-cfd7879b6ef3\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"kL949RnRo@WrWg.noq\",\n \"component_product_id\": \"ab8f6974-b169-a70a-fbe5-2c4e97ded39f\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5329c7e9-1714-4d19-b6fa-de9ee3148484", "name": "Insufficient Stock", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"There is not enough stock to add Fry Pan to your cart\",\n \"meta\": {\n \"id\": \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\"\n },\n \"status\": 400,\n \"title\": \"Insufficient stock\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f9c6901-e943-4add-badf-2b89cccfe792", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"No permissions to fulfill this request with cart item custom_attributes\",\n \"meta\": {\n \"id\": \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\"\n },\n \"status\": 403,\n \"title\": \"Unauthorised call\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc74b74f-da16-4f4b-9bca-7441d0cc07bb", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Item was not found in the cart\",\n \"meta\": {\n \"id\": \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\",\n \"ids\": [\n \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\"\n ]\n },\n \"status\": 404,\n \"title\": \"Not Found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79b693f3-88ea-4708-a595-dbf895424f3e", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"quantity\": 9114,\n \"id\": \"194c1cfe-9cd2-89b9-98af-3082b63bf6c0\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 707.0486433614343\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"c964583f-e045-5fbf-6110-3049657a6017\"\n },\n {\n \"quantity\": 699,\n \"id\": \"84536f07-2d27-40ed-6e80-fdd02ba8e8eb\",\n \"type\": \"custom_item\",\n \"custom_inputs\": {},\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"d5a15c28-d964-d7ac-9378-89839ec23d32\"\n }\n ],\n \"options\": {\n \"update_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The cart is configured to use custom discounts\",\n \"meta\": {\n \"code\": \"10_OFF\",\n \"ids\": [\n \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\"\n ]\n },\n \"status\": 422,\n \"title\": \"Could not apply EP promotion with the given code\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bec2a69e-5f72-4bf0-b1a2-533d63f2a931", "name": "Add Items to Cart", "request": { "name": "Add Items to Cart", "description": { "content": "\n### Add Product to Cart\n\nAdding a Product to Cart is the most common Cart action. If you want to add any custom products or promotions, you need to do that as a separate action.\n\n#### Dynamic Bundles\n\nA bundle is a purchasable product that is composed of a combination of two or more products that you want to sell together. You can create multiple components within a bundle. Each component can have one or more options. Each option is a product and a quantity. You can configure minimum and/or maximum values for the number of product options in a component that your shoppers can select. For example, you can enable a shopper to select 1 or more product options from a list of 10. These are called [dynamic bundles](/docs/api/pxm/products/products#dynamic-bundles).\n\nYour dynamic bundles are displayed in your published catalogs.\n\n1. Use the configure a shopper endpoint to allow shoppers to make their selections from a bundle.\n2. In the response of the configure a shopper, the `bundle_configuration` object contains the bundle selections a shopper has made.\n3. In the add a product to cart request, use the `bundle_configuration` object to add the customers selections to a cart.\n\n```json\n \"bundle_configuration\": {\n \"selected_options\": {\n \"games\": {\n \"d7b79eb8-19d8-45ea-86ed-2324a604dd9c\": 1\n },\n \"toys\": {\n \"0192ccdd-6d33-4898-87d7-c4d87f2bf8ea\": 1,\n \"1aea6f97-f0d9-452c-b3c1-7fb5629ead82\": 1\n }\n }\n}\n```\n\nWhen a cart is checked out, the options a shopper selected are added to the order. See [order items](/docs/api/carts/get-order-items).\n\n#### Personalized Products\n\nYou can allow shoppers to personalize their goods by adding custom text inputs to products directly. This feature is particularly useful for customizable items, such as personalized T-shirts or greeting cards. You can use this functionality by leveraging the `custom_inputs` attribute, and defining the details and validation rules for the custom text.\n\nFirst, you must configure a `custom_inputs` attribute when creating a new product or updating an existing product. Once you have defined your custom inputs on a product, you must configure the custom inputs in your orders.\n\nFor example, you may sell T-shirts that can have personalized text on the front and back of the shirt.\n\n```json\n {\n \"data\": {\n \"type\": \"product\",\n \"attributes\": {\n \"custom_inputs\": {\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n }\n }\n }\n}\n```\n\nIf the same product has different `custom_inputs` attributes, then these are added as separate items in a cart.\n\nThe `custom_inputs` attribute is stored in the cart item and the text for `custom_input` must not exceed 255 characters in length. When a cart is checked out, the `custom_inputs` attribute becomes part of the order.\n\n#### Limitations on Usage of `custom_inputs` with Specific Promotion Types\n\nWhen you add products to a cart with `custom_inputs`, there are certain limitations on usage of the `custom_inputs` with the following promotion types:\n\n - For [Free Gift Promotions](/docs/api/promotions/create-a-promotion), you can add `custom_inputs` to gift items.\n - For [Fixed Bundle Discount Promotions](/docs/api/promotions/create-a-promotion), the promotion applies as long as the cart contains the bundle SKUs even when there are different `custom_inputs`.\n - For [X for Y Discount Promotion and X for amount discount promotion](/docs/api/promotions/create-a-promotion), the promotion applies when there are two SKUs with the same `custom_inputs`. The promotion does not apply when there are different `custom_inputs` and the SKUs are in different line items.\n\n#### Stock locations\n\nWhen adding to a cart it is possible to specify which [stock location](/docs/api/pxm/inventory_mli/inventories-introduction?#multi-location-inventories) should be used for tracking inventory for that product by specifying its slug in `location`. This might represent the warehouse a product is shipped from or the store holding the stock in a Buy Online Pick Up In Store scenario.\n\nEach line item is restricted to a single stock location. If the same product is added with a different location then the most recently-specified location will be used for the total quantity of that line item.\n\n:::note\n\n- Any requests to add a product to cart returns the collection of cart items.\n- [Tax items](/docs/api/carts/tax-items) may optionally be added with the product. Only administrators with [client_credentials access tokens](/docs/api/authentication/create-an-access-token) are able to do this. If included, they replace any existing taxes on the product.\n- The cart currency is set when the first item is added to the cart.\n- The product being added to the cart requires a price in the same currency as the other items in the cart. The API returns a 400 error if a price is not defined in the correct currency.\n- A cart can contain a maximum of 100 unique items. Items include products, custom items, tax items, and promotions.\n- There are a number of actions that happen to your inventory when checking out and paying for an order. For more information, see the [Inventory](/docs/api/pxm/inventory/inventories-introduction) documentation.\n\n:::\n\n### Including Resources\n\nWhen you make an `Add Product to Cart` request to the catalog-view service, you can obtain details of the component products. If you include the optional parameter `include=component_products` in the request, the response will include details for each component product.\n\nWhen a bundle with selected component products is added to a cart, the cart displays both the bundle pricing and component product IDs.\n\nThe response example is returned with a new field called `component_products` under `bundle_configuration`, which is a list of component products that the user has selected for dynamic bundles.\n\n| Parameter | Required | Description |\n|:------------------------|:-------------|:-------------------|\n| `component_products` | Optional | The component product data and key attribute data, such as SKU or slug, to return for component products in a product bundle. |\n| `main_image` | Optional | The main images associated with a product. |\n| `files` | Optional | Any files associated with a product. |\n\n```json\n\"bundle_configuration\": {\n \"selected_options\": {\n \"mixed-shirts\": {\n \"16a6cc14-6ebb-4156-9973-e6a0f92f5731\": 3,\n \"55037cc5-f382-4039-95c6-1e04ac0351d3\": 2,\n \"standard-shirts\"\n \"70f1c9d2-c580-4839-bd6c-a0a9b91d5159\": 5\n }\n },\n \"component_products\": [\n {\n \"id\": \"16a6cc14-6ebb-4156-9973-e6a0f92f5731\",\n \"type\": \"product\",\n \"attributes\": {\n \"name\": \"Red T-shirt\",\n \"description\": \"Standard red t-shirt.\",\n \"slug\": \"red-t-shirt-slug\",\n \"sku\": \"red-t-shirt-sku\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\"\n },\n \"meta\": {\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 500,\n \"currency\": \"USD\",\n \"formatted\": \"$5.00\"\n }\n }\n }\n },\n {\n \"id\": \"55037cc5-f382-4039-95c6-1e04ac0351d3\",\n \"type\": \"product\",\n \"attributes\": {\n \"name\": \"Blue T-shirt\",\n \"description\": \"Standard blue t-shirt.\",\n \"slug\": \"blue-t-shirt-slug\",\n \"sku\": \"blue-t-shirt-sku\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\"\n },\n \"meta\": {\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 500,\n \"currency\": \"USD\",\n \"formatted\": \"$5.00\"\n }\n }\n }\n },\n {\n \"id\": \"70f1c9d2-c580-4839-bd6c-a0a9b91d5159\",\n \"type\": \"product\",\n \"attributes\": {\n \"name\": \"White T-shirt\",\n \"description\": \"Standard white t-shirt.\",\n \"slug\": \"white-t-shirt-slug\",\n \"sku\": \"white-t-shirt-sku\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\"\n },\n \"meta\": {\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 500,\n \"currency\": \"USD\",\n \"formatted\": \"$5.00\"\n }\n }\n }\n }\n ]\n}\n```\n\nSee [Including Resources](https://elasticpath.dev/guides/Getting-Started/includes).\n\n### Add Subscription to Cart\n\nTo add a subscription to your cart, you need to provide the ID of the subscription offering, and the ID of the pricing option and plan within that offering that you want to subscribe to.\n\n```json\n {\n {\n \"data\": {\n \"id\": \"5b9be99f-1c94-4ddd-9718-81adab0cc3e0\",\n \"type\": \"subscription_item\",\n \"quantity\": 1,\n \"subscription_configuration\": {\n \"plan\": \"dfa31307-748c-4369-8571-709f924a0807\",\n \"pricing_option\": \"40010dde-2f38-489b-8b3f-14a13cbfb431\"\n }\n }\n }\n```\n\nThe price of the subscription item in the cart reflects the cost of the subscription's initial billing period. Once the cart has been checked out and the order paid for, the subscription will be automatically created in the subscriptions service.\n\n### Add Custom Item to Cart\n\nYou can add a custom item to the cart when you don't manage things like shipping, taxes and inventory in Commerce.\n\nFor [Shipping Groups](/docs/ship-groups/shipping-groups/index), once you have created a [cart shipping group](/docs/ship-groups/shipping-groups/shipping-groups-api/create-cart-shipping-group), you need to link it to the cart items. This is important, because it is necessary to associate items with shipping groups in order to include shipping groups in the corresponding cart, order, and totals.\n\n:::note\n\n- Custom Cart Items are available when using [implicit access tokens](/docs/api/authentication/create-an-access-token). Ensure that you always check each order has the correct details for each item, most importantly, price.\n\n:::\n\n### Add Promotion to Cart\n\nYou can use the Promotions API to apply discounts to your cart as a special cart item type. Any requests to add a product to cart will return a collection of cart items.\n\n There are certain limitations on usage of the `custom_inputs` attribute with some promotion types. See [Limitations on Usage of `custom_inputs` with Specific Promotion Types](/docs/api/carts/manage-carts#limitations-on-usage-of-custom_inputs-with-specific-promotion-types).\n\nTo remove promotion from the cart via the promotion code, see [Delete Promotion Code from Cart](/docs/api/carts/delete-a-promotion-via-promotion-code).\n\n### Re-order\n\nFrom a shopper's order history, they can add the items from a previous order into their carts. Shoppers can add items regardless of past order status, such as incomplete or not paid. For more information, see [Orders](/docs/api/carts/orders).\n\n:::note\n - Any requests to add an item to cart return a collection of [cart items](/docs/api/carts/cart-items).\n - A cart can contain a maximum of 100 unique items. Items include products, custom items, and promotions.\n - When a shopper creates a cart and re-orders items from an order with properties such as custom attributes, custom discounts, and payment intent ID, these properties will remain unchanged in the original cart.\n - Custom items do not exist in catalogs, and therefore cannot be reordered.\n:::\n\n### Merging Carts\n\nA shopper can have multiple carts, and the system may automatically merge items from an anonymous cart into the shopper's registered cart when they sign in. For example, if a shopper has an existing cart with items `A`, `B` and `C`, and later adds items `D` and `E` while not signed in, the system can merge these carts when the shopper signs in. After the carts merge, the cart contains items `A`, `B`, `C`, `D` and `E`.\n\nIf any items are duplicated from the anonymous cart to the registered cart, their quantities are incremented accordingly. For example, if a shopper's existing cart with items `A`, `B` and `C`, and they later add two more `A` items and one `B` item while not signed in, the system will merge the carts when the shopper signs in. The existing cart will now contain three `A` items, two `B` items, and one `C` item.\n\n:::note\n\nWhen the system merges items from one cart into another cart, properties such as custom attributes, custom discounts, and payment intent ID will remain unchanged in the original cart.\n\n:::\n\n### Best Practices\n\nWe recommend to include a unique `sku` code within the request body while adding custom items to carts. If the same `sku` is used for multiple products, they are merged into a single line item.\n\nFor example, if a cart consists of the following items:\n\n- `product-1` with quantity 1 and sku code as `sku-1`\n- `product-2` with quantity 1 and sku code as `sku-1`\n- `product-3` with quantity 1 and sku code as `sku-2`.\n\nThe following response is returned where it combines all products with the same sku codes into a single line item, while products with a unique sku codes are represented as separate items:\n\n```json\n{\n \"data\": [\n {\n \"id\": \"c58760f4-8889-4719-b34d-be1f1d11ae59\",\n \"type\": \"custom_item\",\n \"name\": \"product-1\",\n \"description\": \"My first custom item!\",\n \"sku\": \"sku-1\",\n \"slug\": \"\",\n \"image\": {\n \"mime_type\": \"\",\n \"file_name\": \"\",\n \"href\": \"\"\n },\n \"quantity\": 2,\n \"manage_stock\": false,\n \"unit_price\": {\n \"amount\": 20000,\n \"currency\": \"USD\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 40000,\n \"currency\": \"USD\",\n \"includes_tax\": true\n },\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 20000,\n \"currency\": \"USD\",\n \"formatted\": \"$200.00\"\n },\n \"value\": {\n \"amount\": 40000,\n \"currency\": \"USD\",\n \"formatted\": \"$400.00\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 20000,\n \"currency\": \"USD\",\n \"formatted\": \"$200.00\"\n },\n \"value\": {\n \"amount\": 40000,\n \"currency\": \"USD\",\n \"formatted\": \"$400.00\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 20000,\n \"currency\": \"USD\",\n \"formatted\": \"$200.00\"\n },\n \"value\": {\n \"amount\": 40000,\n \"currency\": \"USD\",\n \"formatted\": \"$400.00\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"2023-05-02T16:28:11Z\",\n \"updated_at\": \"2023-05-02T16:28:18Z\"\n }\n }\n ]\n ```\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "aba9a660-7a5a-46f1-9229-160a54094d53", "name": "Successfully added item(s) to cart. When promotions are added, the response includes informational messages in the `meta.messages` field describing the promotion and discount effects.", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"1359223e-5de0-4d42-a2ec-14350a84c173\",\n \"type\": \"custom_item\",\n \"name\": \"My Custom Item\",\n \"description\": \"My first custom item!\",\n \"sku\": \"Sample-sku\",\n \"slug\": \"\",\n \"image\": {\n \"mime_type\": \"\",\n \"file_name\": \"\",\n \"href\": \"\"\n },\n \"quantity\": 1,\n \"manage_stock\": false,\n \"unit_price\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"code\": \"auto_4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\",\n \"id\": \"4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\",\n \"promotion_source\": \"rule-promotion\",\n \"is_cart_discount\": true,\n \"ordinal\": 1\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n },\n \"value\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n },\n \"value\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"value\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"formatted\": \"$100.00\"\n },\n \"value\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"formatted\": \"$100.00\"\n }\n },\n \"discounts\": {\n \"auto_4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\",\n \"constituents\": {\n \"4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"2025-09-10T22:28:29Z\",\n \"updated_at\": \"2025-09-10T22:28:29Z\"\n }\n }\n },\n {\n \"id\": \"7a7fb70a-561a-4caf-a112-c3e5a74145f4\",\n \"type\": \"promotion_item\",\n \"promotion_id\": \"4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\",\n \"name\": \"cart auto\",\n \"description\": \"Promotion\",\n \"sku\": \"auto_4c8cc302-b1e8-4d1e-a1d5-fb74fda83705\",\n \"slug\": \"\",\n \"image\": {\n \"mime_type\": \"\",\n \"file_name\": \"\",\n \"href\": \"\"\n },\n \"quantity\": 1,\n \"manage_stock\": false,\n \"unit_price\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"includes_tax\": false\n },\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"value\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"value\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 0,\n \"currency\": \"\",\n \"formatted\": \"0\"\n },\n \"value\": {\n \"amount\": 0,\n \"currency\": \"\",\n \"formatted\": \"0\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"2025-09-10T22:28:29Z\",\n \"updated_at\": \"2025-09-10T22:28:29Z\"\n }\n },\n \"promotion_source\": \"rule-promotion\"\n }\n ],\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n },\n \"without_tax\": {\n \"amount\": 9000,\n \"currency\": \"USD\",\n \"formatted\": \"$90.00\"\n },\n \"tax\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"discount\": {\n \"amount\": -1000,\n \"currency\": \"USD\",\n \"formatted\": \"-$10.00\"\n },\n \"without_discount\": {\n \"amount\": 10000,\n \"currency\": \"USD\",\n \"formatted\": \"$100.00\"\n },\n \"shipping\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"2025-09-08T13:17:42Z\",\n \"updated_at\": \"2025-09-10T22:28:29Z\",\n \"expires_at\": \"2025-09-17T22:28:29Z\"\n },\n \"messages\": [\n {\n \"source\": {\n \"type\": \"promotion_item\",\n \"id\": \"7a7fb70a-561a-4caf-a112-c3e5a74145f4\"\n },\n \"title\": \"Promotion Added\",\n \"description\": \"Promotion has been added to cart.\"\n },\n {\n \"source\": {\n \"type\": \"custom_item\",\n \"id\": \"1359223e-5de0-4d42-a2ec-14350a84c173\"\n },\n \"title\": \"Discount Added\",\n \"description\": \"Item discount has been added.\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e3f55a1-ed69-4274-9375-c41380003f1c", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Must be greater than or equal to 0\",\n \"meta\": {\n \"value\": -100000\n },\n \"status\": 400,\n \"title\": \"number_gte\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2ba9942-9823-4907-857b-65a730f6bdcf", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"No permissions to fulfill this request with cart item custom_attributes\",\n \"status\": 403,\n \"title\": \"Unauthorised call\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8488218-2733-4101-aefa-b021abcde07e", "name": "Not Found - occurs when a referenced product or promotion cannot be found. For bulk operations with add_all_or_nothing=true, the entire operation fails if any item is invalid.", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The requested product could not be found\",\n \"meta\": {\n \"id\": \"1c73326e-07e0-4043-81fc-54b8f13daeb4\"\n },\n \"status\": 404,\n \"title\": \"Product not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "468ec4ad-1a00-4ba7-b67f-e9e7335f8bb0", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The cart is configured to use custom discounts\",\n \"meta\": {\n \"code\": \"10_OFF\",\n \"ids\": [\n \"0e5bae32-cc71-4ede-8d7d-cb662e90c542\"\n ]\n },\n \"status\": 422,\n \"title\": \"Could not apply EP promotion with the given code\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ff82c92-ae12-4a00-aeab-97235f79e5ce", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"df32387b-6ce6-4802-9b90-1126a5c5a54f\",\n \"quantity\": 1,\n \"custom_inputs\": {\n \"name\": {\n \"tshirt_front\": \"Jane\",\n \"tshirt_back\": \"Jane Doe's Dance Academy\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6fa16e77-93da-47a2-9dc2-1c6aeb3bc32e", "name": "Delete all Cart Items", "request": { "name": "Delete all Cart Items", "description": { "content": "A shopper can clean up their cart, deleting custom items, promotions, and so on, while the empty cart remains available. The cart id, name, description, and any account or customer associations persist. The shopper can continue to add items to the cart.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart created by you.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "1ca29ccc-c654-4fa0-8bdb-a37c3f8ba436", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "064f68fa-6428-4e3b-8994-f75f6746998e", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The cart is configured to use custom discounts\",\n \"meta\": {\n \"code\": \"10_OFF\"\n },\n \"status\": 422,\n \"title\": \"Could not apply EP promotion with the given code\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f3089d93-9a46-41fd-9c0b-8753f0e9fb28", "name": "Update a Cart Item", "request": { "name": "Update a Cart Item", "description": { "content": "You can easily update a cart item. A successful update returns the cart items.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) A unique identifier of the cart that you created.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) A unique identifier of the cart item.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\",\n \"custom_inputs\": {\n \"personalization\": \"My personal message\"\n },\n \"quantity\": 2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0ea5c74e-063e-435d-81f6-81605f17c188", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\",\n \"custom_inputs\": {\n \"personalization\": \"My personal message\"\n },\n \"quantity\": 2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"06a9dd8d-ccbc-b0b0-3821-9ac2395e342a\",\n \"type\": \"subscription_item\",\n \"product_id\": \"5f9f82d4-a486-800b-9708-3b6c7f5f1f37\",\n \"promotion_id\": \"8c891fc0-8b50-84bf-f4ed-2f1c33e5c6d9\",\n \"subscription_offering_id\": \"8252de70-39b1-b9ac-3bb5-b4a1f7e41e14\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"6f016736-b09c-8b71-15c9-e413ac716ebf\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 3389.0001901081823\n },\n \"key_1\": {\n \"key_0\": 5525.62499871051,\n \"key_1\": 5811.885765457368\n },\n \"key_2\": {\n \"key_0\": 96.58028073439739,\n \"key_1\": 4855.554349360263\n },\n \"key_3\": {\n \"key_0\": 7617.083210233202\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 2892.1939672159237,\n \"key_1\": 4786,\n \"key_2\": 6937.164260253446\n },\n \"meta\": {\n \"key_0\": 4865.2362346038935,\n \"key_1\": 7175.606854753931\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 699\n },\n \"relationships\": {\n \"key_0\": 9263\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": 5507\n },\n \"meta\": {\n \"key_0\": 6453.324771515027,\n \"key_1\": 3937.5248294054945,\n \"key_2\": 4578.81636042607\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 9095,\n \"key_2\": \"string\"\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7029.712197194455,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5449.879327912242,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 2253.682922182023,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 8264.315917715563,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 3072,\n \"auto_add_quantity\": 3058,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 887.6700414430561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 1694.5029349416395,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2747,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9150\n },\n {\n \"amount\": {\n \"amount\": 6048,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 5812\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 5955,\n \"key_1\": 733,\n \"key_2\": 236\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 1751.3234408257206,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4564.125175591392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 6056.953665708626,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5136.403054601157,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 9576.776958099961,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2828.515083273393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4473.471673719123,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 1818.9950118407894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 8701.47077503657,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9670.318262600964,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 4270.02164136627,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 3371.949000973784,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 3486,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5895.567765203525,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 4782.185844269602\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": \"string\"\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 2918.89603226005\n },\n \"key_3\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n }\n },\n {\n \"id\": \"780d700f-9e1f-089d-e670-c4e9d1b8bbad\",\n \"type\": \"cart_item\",\n \"product_id\": \"f0040996-173e-ad02-701b-9513b5227b0f\",\n \"promotion_id\": \"27ce6dc5-52f1-d0b3-3d6c-1884e0e1d8e3\",\n \"subscription_offering_id\": \"c40c5fb3-2a53-87db-184a-e1475ae3f351\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"1ba2ae21-4132-ca6f-e998-293f2151dd7a\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 8802.079264829716,\n \"key_1\": 102.60758189666097\n },\n \"key_1\": {\n \"key_0\": 7764.539374460695,\n \"key_1\": 3831.859127151165\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": false,\n \"key_1\": 6303.563953599187\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 5534.192793241304\n },\n \"relationships\": {\n \"key_0\": 3085,\n \"key_1\": 6703\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 1727.6049731968458\n },\n \"price\": {\n \"key_0\": \"string\"\n },\n \"relationships\": {\n \"key_0\": 7809.292540608337,\n \"key_1\": 8768.606062758225,\n \"key_2\": 4309.465678744508\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3493.8003798956906,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5858.539264830433,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 6522.075700622907,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 4443.4647542588455,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 7101,\n \"auto_add_quantity\": 6626,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 7845.317782972898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 7673.560783059126,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 4798,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 1275\n },\n {\n \"amount\": {\n \"amount\": 13,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 38\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 8640,\n \"key_1\": 8026.152604440926,\n \"key_2\": false\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 3848.021571349649,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 98.79277502554906,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8783.221410209395,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 218.76390597248997,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5515.707667289902,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7631.631635687106,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4574.392993375609,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6542.06596979878,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 429.434750081088,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6963.921964561122,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 2765.234173584994,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4837.964154727596,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 8094,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7816.611873300827,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 6928.8976954392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 2050,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 1598.7136035679384,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n }\n }\n }\n ],\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"887664f4-89cb-b973-c918-70f4a4fae0cb\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 1398.6853966216195,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7b6ba392-b9ff-4feb-ee9a-9a32f91b83b8\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"b2f668ca-c21e-ff63-aa70-5601d4971d9d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2954.0762137677048,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"d0fb3df7-5272-d75d-5112-c7a64ee6b61a\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1958-08-26T04:31:45.983Z\",\n \"id\": \"b405501f-f6d2-69ae-ca33-1718e031421a\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2008-08-09T01:11:17.886Z\",\n \"type\": \"string\"\n },\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1970-03-23T03:25:05.769Z\",\n \"id\": \"b2c3a9b0-4222-874d-e080-5accab190de9\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1960-09-27T16:06:57.505Z\",\n \"type\": \"string\"\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"241b88d7-80e8-e616-5aa5-f89860b5071d\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 3715.0423959626623,\n \"amount\": 2467\n },\n {\n \"type\": \"string\",\n \"id\": \"b5414547-4127-5f6a-b552-ed31cb7e205c\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 9110.43708142179,\n \"amount\": 4217\n }\n ]\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7069.468292199174,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 4544.84380566857,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 5496.914602478389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 39.41110038222728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 5313.856506253922,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2931.0042227437248,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 3668.020900024402,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 4741.445612019866,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 862.3112963780022,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 8648.309098615095,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"messages\": [\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n },\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n }\n ],\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7853,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8834,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 1383,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 4614,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7514,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4116,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 2162,\n \"key_1\": 9507\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 5380,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 3635,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 2078,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"yQvpu@jdPITBmPYvIHHKgqkZneVlaFmCpNm.xr\",\n \"component_product_id\": \"7368ad1b-6a14-8bfe-e7f4-cfd7879b6ef3\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"kL949RnRo@WrWg.noq\",\n \"component_product_id\": \"ab8f6974-b169-a70a-fbe5-2c4e97ded39f\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c71e213-5806-427b-abd6-06409bd85cf7", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\",\n \"custom_inputs\": {\n \"personalization\": \"My personal message\"\n },\n \"quantity\": 2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The existing shipping group uses USD, cannot add this shipping group to a cart item with currency GBP\",\n \"meta\": {\n \"item_ids\": [\n \"51197fc0-e217-4f69-a769-b3887f58cfff\"\n ],\n \"shipping_group_id\": \"fcb87ec9-a7fb-48c2-bcd9-2151b64e1abc\"\n },\n \"status\": 404,\n \"title\": \"Cart Currency Mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e547063a-d2d9-4d09-baf6-f789428be8e3", "name": "Unauthorized call", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\",\n \"custom_inputs\": {\n \"personalization\": \"My personal message\"\n },\n \"quantity\": 2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"No permissions to fulfill this request with cart item custom_attributes\",\n \"meta\": {\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\"\n },\n \"status\": 403,\n \"title\": \"Unauthorised call\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7899155-14c9-44cd-9dc6-361cfc9637c2", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart that you created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"76746981-f63a-45f4-ba9e-59773d89dc2e\",\n \"custom_inputs\": {\n \"personalization\": \"My personal message\"\n },\n \"quantity\": 2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Shipping groups not found for this cart. Please verify the shipping groups exists for this cart and are not already associated with orders.\",\n \"meta\": {\n \"cart_id\": \"a-cart-id\",\n \"shipping_group_ids\": [\n \"fcb87ec9-a7fb-48c2-bcd9-2151b64e1abc\"\n ]\n },\n \"status\": 404,\n \"title\": \"Shipping groups not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6cb39263-8c81-4dab-b521-39d24539e62c", "name": "Delete a Cart Item", "request": { "name": "Delete a Cart Item", "description": { "content": "Use this endpoint to delete a cart item.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart created by you.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "573575cf-f7fd-48b0-a04d-94418108923b", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"06a9dd8d-ccbc-b0b0-3821-9ac2395e342a\",\n \"type\": \"subscription_item\",\n \"product_id\": \"5f9f82d4-a486-800b-9708-3b6c7f5f1f37\",\n \"promotion_id\": \"8c891fc0-8b50-84bf-f4ed-2f1c33e5c6d9\",\n \"subscription_offering_id\": \"8252de70-39b1-b9ac-3bb5-b4a1f7e41e14\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"6f016736-b09c-8b71-15c9-e413ac716ebf\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 3389.0001901081823\n },\n \"key_1\": {\n \"key_0\": 5525.62499871051,\n \"key_1\": 5811.885765457368\n },\n \"key_2\": {\n \"key_0\": 96.58028073439739,\n \"key_1\": 4855.554349360263\n },\n \"key_3\": {\n \"key_0\": 7617.083210233202\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 2892.1939672159237,\n \"key_1\": 4786,\n \"key_2\": 6937.164260253446\n },\n \"meta\": {\n \"key_0\": 4865.2362346038935,\n \"key_1\": 7175.606854753931\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 699\n },\n \"relationships\": {\n \"key_0\": 9263\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": 5507\n },\n \"meta\": {\n \"key_0\": 6453.324771515027,\n \"key_1\": 3937.5248294054945,\n \"key_2\": 4578.81636042607\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 9095,\n \"key_2\": \"string\"\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7029.712197194455,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5449.879327912242,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 2253.682922182023,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 8264.315917715563,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 3072,\n \"auto_add_quantity\": 3058,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 887.6700414430561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 1694.5029349416395,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2747,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9150\n },\n {\n \"amount\": {\n \"amount\": 6048,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 5812\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 5955,\n \"key_1\": 733,\n \"key_2\": 236\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 1751.3234408257206,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4564.125175591392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 6056.953665708626,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5136.403054601157,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 9576.776958099961,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2828.515083273393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4473.471673719123,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 1818.9950118407894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 8701.47077503657,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9670.318262600964,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 4270.02164136627,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 3371.949000973784,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 3486,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5895.567765203525,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 4782.185844269602\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": \"string\"\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 2918.89603226005\n },\n \"key_3\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n }\n },\n {\n \"id\": \"780d700f-9e1f-089d-e670-c4e9d1b8bbad\",\n \"type\": \"cart_item\",\n \"product_id\": \"f0040996-173e-ad02-701b-9513b5227b0f\",\n \"promotion_id\": \"27ce6dc5-52f1-d0b3-3d6c-1884e0e1d8e3\",\n \"subscription_offering_id\": \"c40c5fb3-2a53-87db-184a-e1475ae3f351\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"sku\": \"string\",\n \"slug\": \"string\",\n \"catalog_id\": \"1ba2ae21-4132-ca6f-e998-293f2151dd7a\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 8802.079264829716,\n \"key_1\": 102.60758189666097\n },\n \"key_1\": {\n \"key_0\": 7764.539374460695,\n \"key_1\": 3831.859127151165\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": false,\n \"key_1\": 6303.563953599187\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": \"string\",\n \"key_1\": 5534.192793241304\n },\n \"relationships\": {\n \"key_0\": 3085,\n \"key_1\": 6703\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 1727.6049731968458\n },\n \"price\": {\n \"key_0\": \"string\"\n },\n \"relationships\": {\n \"key_0\": 7809.292540608337,\n \"key_1\": 8768.606062758225,\n \"key_2\": 4309.465678744508\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3493.8003798956906,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 5858.539264830433,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 6522.075700622907,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 4443.4647542588455,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"image\": {\n \"mime_type\": \"string\",\n \"file_name\": \"string\",\n \"href\": \"string\"\n },\n \"quantity\": 7101,\n \"auto_add_quantity\": 6626,\n \"manage_stock\": true,\n \"unit_price\": {\n \"amount\": 7845.317782972898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 7673.560783059126,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 4798,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 1275\n },\n {\n \"amount\": {\n \"amount\": 13,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 38\n }\n ],\n \"custom_inputs\": {\n \"key_0\": 8640,\n \"key_1\": 8026.152604440926,\n \"key_2\": false\n },\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n },\n \"links\": {\n \"product\": \"string\",\n \"subscription_offering\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 3848.021571349649,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 98.79277502554906,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8783.221410209395,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 218.76390597248997,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5515.707667289902,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7631.631635687106,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 4574.392993375609,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6542.06596979878,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 429.434750081088,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6963.921964561122,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 2765.234173584994,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4837.964154727596,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 8094,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7816.611873300827,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 6928.8976954392,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 2050,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 1598.7136035679384,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"taxes\": {\n \"data\": null\n },\n \"custom_discounts\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"rule-promotion\",\n \"location\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n }\n }\n }\n ],\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"887664f4-89cb-b973-c918-70f4a4fae0cb\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 1398.6853966216195,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7b6ba392-b9ff-4feb-ee9a-9a32f91b83b8\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"b2f668ca-c21e-ff63-aa70-5601d4971d9d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2954.0762137677048,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"d0fb3df7-5272-d75d-5112-c7a64ee6b61a\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1958-08-26T04:31:45.983Z\",\n \"id\": \"b405501f-f6d2-69ae-ca33-1718e031421a\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2008-08-09T01:11:17.886Z\",\n \"type\": \"string\"\n },\n {\n \"automatic\": false,\n \"description\": \"string\",\n \"end\": \"1970-03-23T03:25:05.769Z\",\n \"id\": \"b2c3a9b0-4222-874d-e080-5accab190de9\",\n \"name\": \"string\",\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1960-09-27T16:06:57.505Z\",\n \"type\": \"string\"\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"241b88d7-80e8-e616-5aa5-f89860b5071d\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 3715.0423959626623,\n \"amount\": 2467\n },\n {\n \"type\": \"string\",\n \"id\": \"b5414547-4127-5f6a-b552-ed31cb7e205c\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 9110.43708142179,\n \"amount\": 4217\n }\n ]\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7069.468292199174,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 4544.84380566857,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 5496.914602478389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 39.41110038222728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 5313.856506253922,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2931.0042227437248,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 3668.020900024402,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 4741.445612019866,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 862.3112963780022,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 8648.309098615095,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"messages\": [\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n },\n {\n \"title\": \"string\",\n \"description\": \"string\",\n \"source\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"code\": \"string\"\n }\n }\n ],\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7853,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 8834,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 1383,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 4614,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 7514,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4116,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 2162,\n \"key_1\": 9507\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\",\n \"auto_add\": true,\n \"targets\": [\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 5380,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n },\n {\n \"cart_item_id\": \"string\",\n \"quantity\": 3635,\n \"skus\": [\n \"string\",\n \"string\"\n ]\n }\n ]\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 2078,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"yQvpu@jdPITBmPYvIHHKgqkZneVlaFmCpNm.xr\",\n \"component_product_id\": \"7368ad1b-6a14-8bfe-e7f4-cfd7879b6ef3\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"kL949RnRo@WrWg.noq\",\n \"component_product_id\": \"ab8f6974-b169-a70a-fbe5-2c4e97ded39f\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "35f9c74d-96bf-4c16-9923-806e242edf9b", "name": "Delete a Promotion via Promotion Code", "request": { "name": "Delete a Promotion via Promotion Code", "description": { "content": "You can remove promotion code from a cart if it was applied manually. This endpoint does not work if the promotion is applied automatically.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "discounts", ":promoCode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of a cart created by you.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "promoCode", "disabled": false, "description": { "content": "(Required) Specifies the promotion code to be deleted.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "e347db1f-ab1e-4656-931f-b932af7163db", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "discounts", ":promoCode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of a cart created by you.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the promotion code to be deleted.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promoCode" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Checkout", "description": "\nThe checkout workflow ties together many of the key concepts covered in this section. When a customer initiates the checkout process, an order is created from the cart. The order is incomplete until after a successful payment is made. A complete order can be shipped and the product deducted from inventory counts.\n\n![Checkout workflow](/assets/checkout-flow.png)\n\n### Summary of the checkout workflow\n\n1. Add a product to a cart. A cart and its reference number is generated.\n2. Manage the cart items. For example, you might add items, remove items, and change quantities.\n3. Check out the cart. An incomplete order is created.\n4. Pay for an order: provide billing and shipping details, if you are a new customer. The order is now in the processing status.\n5. If using a manual gateway, after you authorize and capture it, Composable Commerce considers the order complete. If you use a third-party integration supported by Composable Commerce (such as Stripe), after the third-party gateway authorizes and captures the payment, the order becomes complete. Usually capture does not occur at the same time as authorization. For more information, see the Capture section.\n6. After the order is shipped, you can manually flag it as fulfilled.\n\n### Carts\n\nWhen a product is added to a cart, a cart is generated together with its unique reference ID that on checkout becomes a part of the order ID. If you are using our JavaScript software development kit, generating a cart reference ID is done for you; otherwise, add a cart reference generator to your functionality.\n\n### Promotions and custom items\n\nOptionally, apply a promotion code on a cart, or add custom_items to modify the product price (typically to handle taxes, customs, or shipping).\n\n### Checkout\n\nYou can checkout a cart with an associated customer name and email (customer object). Typically, this would be used for new customers or ones that prefer to shop as guests. Use the `customer.id` checkout option to checkout for an existing customer. After a successful checkout is completed, the response contains an order.\n\nEmail addresses that either begin or end with a period, or contain consecutive periods, are considered invalid, resulting in the following error:\n```json\n\"errors\": [\n {\n \"status\": 400,\n \"source\": \"data.customer.email\",\n \"title\": \"format\",\n \"detail\": \"Does not match format 'email'\"\n }\n]\n ```\n\n### Payments\n\nOn checkout, an incomplete order is created. You can then use a third-party integration to handle your payment gateway. If the payment gateway is supported by Composable Commerce, such as Stripe, the payment is processed externally but handled internally. When a successful validation is returned, Composable Commerce flags the order as complete.\n\nIf you are using a payment method not officially supported by Composable Commerce, the gateway needs to be implemented and handled manually. After the payment has been authorized and captured either through Commerce Manager or API, the status of an order becomes complete.\n\n### Shipping\n\nThe status of an order and the status of shipping are handled separately, and so an order can be complete but not shipped. Orders that have not been shipped yet have a status of unfulfilled. This flag is generated automatically by Composable Commerce when an order is created. Currently, you can only update the shipping status manually, through the API. After the order is shipped, flag its shipping status as fulfilled.\n\n### Inventory\n\nIf enabled, you can manage your stock. As such, your stock is automatically updated as soon as a product is checked out.\n", "item": [ { "id": "e9e63837-8fe4-4f26-bcce-cdd831177e8a", "name": "Checkout API", "request": { "name": "Checkout API", "description": { "content": "When a Cart is ready for checkout, you can convert the cart to an order. The cart remains and can be modified and checked out again if required.\n\nA cart can be checked out with a customer ID, customer object, or with an account by authenticating with the `Client Credentials Token`.\n\nAfter a successful checkout, a response that contains the order is returned. If the cart is linked to a shipping group, the shipping group is also associated with the order after checkout.\n\nYou can checkout using one of the following methods:\n- **Customer ID**: You can checkout a cart with an existing customer ID.\n- **Guest Checkout** (Checkout with Customer Object): You can checkout a cart with an associated customer name and email.\n- **Checkout with Account**: The shopper authenticates with the `Client Credentials` Token.\n- **Checkout with Account Management Authentication Token**: The shopper authenticates with the `Implicit Token` and the `EP-Account-Management-Authentication-Token`.\n\n:::note\n\n- The cart currency is set when the first item is added to the cart.\n- The product being added to the cart requires a price in the same currency as the other items in the cart. The API returns a 400 error if a price is not defined in the correct currency.\n- To ensure that a free gift is automatically applied to an order, set the promotion to automatic. The checkout process will not be successful if free gift items are out of stock. See [Errors](#errors) section.\n\n:::\n\n:::caution\n\n- By default, carts are automatically deleted 7 days after the last update. You can change this setting by [updating cart settings](/docs/api/carts/put-v-2-settings-cart).\n- Your inventory is modified during checkout and payment of an order. For more information about the changes in the inventory, see the [Inventory](/docs/api/pxm/inventory/inventories-introduction) section.\n\n:::\n\n You can pass `order_number` and `external_ref` in the checkout endpoint or when [updating an order](/docs/api/carts/update-an-order). The `order_number` is an optional, user-managed field that is used as an alternative to `order_id`. When processing transactions through Authorize.net, the `order_number` is sent instead of the `order_id`, and it will appear in the invoice number section. If no `order_number` is provided, the `order_id` is sent to Authorize.net on payment by default. There are no duplication restrictions on the `order_number` value.\n\n### Next Steps\n\nAfter a cart has been converted to an Order using either of the previous methods, you most likely want to capture payment for order. See [Paying for an Order](/docs/api/carts/payments).\n\n### Errors\n\nThe following error response is returned during checkout when an eligible item is added to the cart, and the free gift is out of stock.\n\n```json\n{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Insufficient stock\",\n \"detail\": \"There is not enough stock to add gift2 to your cart\",\n \"meta\": {\n \"id\": \"f2b68648-9621-45a3-aed6-1b526b0f5beb\",\n \"sku\": \"gift2\"\n }\n }\n ]\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID of the cart that you want to checkout.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "An account management authentication token that identifies the authenticated account member.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_number\": \"order-1234\",\n \"external_ref\": \"e-123456789\",\n \"customer\": {\n \"id\": \"c8c1c511-beef-4812-9b7a-9f92c587217c\"\n },\n \"billing_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\"\n },\n \"shipping_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\",\n \"instructions\": \"Leave in porch\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b0fe5421-4679-4121-b7c3-53492e9f779a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart that you want to checkout.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An account management authentication token that identifies the authenticated account member.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_number\": \"order-1234\",\n \"external_ref\": \"e-123456789\",\n \"customer\": {\n \"id\": \"c8c1c511-beef-4812-9b7a-9f92c587217c\"\n },\n \"billing_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\"\n },\n \"shipping_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\",\n \"instructions\": \"Leave in porch\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"2d32a450-533e-dae4-e61b-ce6009ae8242\",\n \"status\": \"incomplete\",\n \"payment\": \"authorized\",\n \"shipping\": \"fulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 1957.8586099001138\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9914.493777910444,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 6534.581765664636,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3993.132637498735,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 7610.119175361509,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 3109.494570225515,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 1789.1502089884393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 2533.5289689936944,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2689.233629716352,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": false\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"uposf@pmMVltoNOoWzYyDOfnckDycndK.pwxg\",\n \"id\": \"667df9c7-eac5-3728-7d93-f1308b8315da\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"dabf0383-be37-c4a6-2d37-8b43d9aedbb9\"\n },\n {\n \"type\": \"string\",\n \"id\": \"43e1b4a2-419c-3464-5f0f-02ec199da1a3\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"ed5b83c0-99ad-dbd4-0875-dd46853e30cb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"66f21715-c843-404f-1029-c2c7a82bbd57\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"c02555aa-89aa-ad55-bf03-e86b1614e07f\"\n },\n {\n \"type\": \"string\",\n \"id\": \"7afc2bd1-d3fa-ed92-51b0-7ec3c786e0a1\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"709af4a5-4928-e34d-702f-aff150418af8\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"d602ea40-6de7-250e-a872-9370359f4553\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"de887a1b-10cd-4745-be8e-20da6050fec0\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"c087d401-4cb1-e9f9-46d0-fda0815b8ad3\"\n }\n }\n }\n },\n \"included\": {\n \"items\": [\n {\n \"type\": \"string\",\n \"id\": \"842e2744-60df-8624-7e0a-5c8cbaa3a6c8\",\n \"quantity\": 6888.60395358758,\n \"product_id\": \"a7b0c376-3151-a6a3-c172-9358a1245655\",\n \"subscription_offering_id\": \"a9d6bafe-4689-6e1e-bea6-3634a103ded5\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 9436.10000270601,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 9538.241478140813,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2601.156117857546,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"268a9f6e-dc94-2e90-267b-f0dc850f9dab\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 9115\n },\n {\n \"amount\": {\n \"amount\": 1049.5277781388945,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"be973d1c-4295-7709-edd3-0c22f8e715aa\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 3189\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 4626.177841045273,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4574.5675202631155,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 3217.7312688181314,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7930.931882413619,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 2206.7785907573457,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5163.3669421378545,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 9522.257406302158,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 8215.982623078835,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 9980.371197817489,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9652.012103091076,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 1079.2484248731894,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 8478.537585688131,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 4861.473154119789,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9691.801629445676,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 4378.15932345391,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5600.926366436165,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 7756.688467992294,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6644.066801841311,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fafa4065-47c6-f69c-27a3-c632e8a37dbb\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 6701.822971992071\n },\n \"key_1\": {\n \"key_0\": 6486.558347741591,\n \"key_1\": 5191.488692014918,\n \"key_2\": 3961.4102399349063\n },\n \"key_2\": {\n \"key_0\": 8320.853790433574,\n \"key_1\": 9692.944180396233\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 3855.395983711096,\n \"key_1\": 9998.291742750396\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": 8194.368343318545\n },\n \"price\": {\n \"key_0\": 4129.387559264366\n },\n \"relationships\": {\n \"key_0\": \"string\",\n \"key_1\": 1741\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": 6167.408551751856,\n \"key_1\": 4650.914229215042\n },\n \"relationships\": {\n \"key_0\": 589,\n \"key_1\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7759.698488998277,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9240.45897428168,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7675.701091361011,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9905.882121518216,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 6704.724689161119\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 1164.656489770377\n },\n \"key_1\": {\n \"type\": \"string\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"7918a510-c7fd-a9e4-49fe-fbf832a78016\",\n \"quantity\": 7917.876154416516,\n \"product_id\": \"6407c604-e8ef-5603-b0da-eba6f832126c\",\n \"subscription_offering_id\": \"bb7c364c-078b-1a24-37f1-6eccaea236fc\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 8691.048216114037,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 114.68266383086956,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 8890.840721620561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"c8f7622f-8fd9-ad96-d299-d8237d671da8\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 6597\n },\n {\n \"amount\": {\n \"amount\": 3478.3804999638955,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"d0867f69-d731-7b7e-b0f0-a6d217a1cff5\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 8291\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 8686.4633282287,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2383.37801681362,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8858.458934685113,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 92.19540254058688,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 834.1383725656004,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7318.660348167079,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 6362.5041725779965,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4078.552510373854,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 6132.458908267291,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6909.41235690766,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 2769.0804153170266,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 6619.978990433963,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 4396.29986230003,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 8921.262328006758,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9289.302071420389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 7235.773021518968,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 3860.857798083479,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9930.07840323203,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"bc0c3c4b-ace6-1312-d337-a69be9713f1f\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 1321.4463509546538,\n \"key_1\": 9260.620249881651\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 1566.406834004559\n },\n \"meta\": {\n \"key_0\": 7217.275885746026\n },\n \"price\": {\n \"key_0\": 1570,\n \"key_1\": 3476\n },\n \"relationships\": {\n \"key_0\": true,\n \"key_1\": 9276.396649909135,\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": true\n },\n \"meta\": {\n \"key_0\": 9248.328142988285,\n \"key_1\": true\n },\n \"price\": {\n \"key_0\": 9411.304838629463\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 519.5887919374642,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 1557.0726404282964,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": \"string\",\n \"key_1\": 8997.161529532606,\n \"key_2\": \"string\"\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"boolean\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"e474d629-18a9-904e-cd4b-259761cc7098\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 2377.5671907347173,\n \"amount\": 7148\n },\n {\n \"type\": \"string\",\n \"id\": \"e92cfacd-9305-5fdc-4cd8-7e08b3d9d10b\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 5084.716113186627,\n \"amount\": 1707\n }\n ],\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"740a639c-db0e-88c5-c532-5c7d7099c82c\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2342.42409538604,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"9abddc4c-4867-05e9-9432-b76855ffe1f4\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"643f3ead-7c0e-9a35-bc7c-c8e9b90f121d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 4948.603957436144,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"05fbb349-a859-cdaf-59a2-e970f9c0ba01\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"472788b5-72fb-e011-def2-b0b4a42e4d88\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1973-07-06T23:59:28.397Z\",\n \"end\": \"1953-02-04T23:20:02.122Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"0604432c-db06-4ea2-d154-bc3f7d4d48eb\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1962-07-08T07:48:03.909Z\",\n \"end\": \"1981-01-10T15:07:42.183Z\"\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 8083,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"Zemzh02qUKff@SbFvYUEpqDsITKFMmCrbBZwagSw.frr\",\n \"component_product_id\": \"4c337f69-436a-966f-e1d1-221a8d776685\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 2968,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"jQNCVrFzx7vZ@ifzOeYFoPdugGzQD.qg\",\n \"component_product_id\": \"7781c249-5344-218a-4d7d-b44cdcf3cebc\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c737e285-41d7-4e52-ac51-3f2dca739f93", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart that you want to checkout.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An account management authentication token that identifies the authenticated account member.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_number\": \"order-1234\",\n \"external_ref\": \"e-123456789\",\n \"customer\": {\n \"id\": \"c8c1c511-beef-4812-9b7a-9f92c587217c\"\n },\n \"billing_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\"\n },\n \"shipping_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\",\n \"instructions\": \"Leave in porch\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b408008-9c68-46d4-bbdd-dea778b4b9d9", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart that you want to checkout.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "disabled": false, "description": { "content": "An account management authentication token that identifies the authenticated account member.", "type": "text/plain" }, "key": "EP-Account-Management-Authentication-Token", "value": "{{accountToken}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_number\": \"order-1234\",\n \"external_ref\": \"e-123456789\",\n \"customer\": {\n \"id\": \"c8c1c511-beef-4812-9b7a-9f92c587217c\"\n },\n \"billing_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\"\n },\n \"shipping_address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"Moltin\",\n \"line_1\": \"1234 Disney Drive\",\n \"line_2\": \"Disney Resort\",\n \"city\": \"Anaheim\",\n \"county\": \"Orange\",\n \"region\": \"CA\",\n \"postcode\": \"92802\",\n \"country\": \"US\",\n \"instructions\": \"Leave in porch\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Orders", "description": "An Order is created through the [checkout](/docs/api/carts/checkout) endpoint within the Carts API.\n\nAn order is created after a customer checks out their cart. On creation, the order is marked unpaid. The customer is prompted for a shipping address, a billing address, and a payment method. After the order is successfully paid, you can trigger an inventory process and a shipping process.\n\nYou can keep a history of orders associated with the customer account.\n\n### Reorder\n\nA re-order is when a shopper copies items from a previous order from their order history into a cart of their choice. If a shopper re-orders to an empty cart, the same quantities as the past order are applied. If the shopper re-orders to an existing cart, and orders the same item, the quantity increases. If an item is out of stock, the item is not added to the cart, and the shopper sees an insufficient stock error. The tax for the items in a re-order is not applied. For more information, see [Tax Items](/docs/api/carts/tax-items).\n", "item": [ { "id": "bf4e1026-add0-4395-a7ac-174fe0cc3ad0", "name": "Get all Orders", "request": { "name": "Get all Orders", "description": { "content": "This endpoint returns all orders with custom flow fields. The pagination offset is set to fetch a maximum of 10,000 orders. If the store has 10,000 orders, and you fetch the orders without using filters, an error is returned. Use a filter to view orders when the order is beyond the 10,000 mark.\n\n:::note\n\n- Pass the `X-Moltin-Customer-Token` header to limit orders to a specific customer. See [Customer Tokens](/docs/customer-management/customer-management-api/customer-tokens).\n- Pass the `EP-Account-Management-Authentication-Token` header to limit orders to a specific account. See [Account Management Token](/docs/api/accounts/post-v-2-account-members-tokens).\n- You can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n:::\n\n### Filtering\n\nThe following operators and attributes are available for filtering orders.\n\n| Attribute | Type | Operator | Example |\n| :--- | :--- | :--- | :--- |\n| `status` | `string` | `eq` | `eq(status,complete)` |\n| `payment` | `string` | `eq` | `eq(payment,paid)` |\n| `shipping` | `string` | `eq` | `eq(shipping,unfulfilled)` |\n| `name` (`customer.name`) | `string` | `eq` / `like` | `like(name,Brad*)` |\n| `email` (`customer.email`) | `string` | `eq` / `like` | `like(email,*@elasticpath.com)` |\n| `customer_id` | `string` | `eq` / `like` | `eq(customer_id, e5a0d684-a4af-4919-a348-f66b0b4955e0)` |\n| `account_id` | `string` | `eq` / `like` | `eq(account_id,3d7200c9-a9bc-4085-9822-63e80fd94a09)` |\n| `account_member_id` | `string` | `eq` / `like` | `eq(account_member_id,2a8a3a92-2ccd-4b2b-a7af-52d3896eaecb)` |\n| `contact.name` | `string` | `eq` / `like` | `eq(name,John Doe)` |\n| `contact.email` | `string` | `eq` / `like` | `eq(email,John Doe)` |\n| `shipping_postcode` | `string` | `eq` / `like` | `like(shipping_postcode,117*)` |\n| `billing_postcode` | `string` | `eq` / `like` | `like(billing_postcode,117*)` |\n| `with_tax` | `integer` | `gt`/`ge`/`lt`/`le` | `ge(with_tax,10000)` |\n| `without_tax` | `integer` | `gt`/`ge`/`lt`/`le` | `ge(without_tax,10000)` |\n| `currency` | `string` | `eq` | `eq(currency,USD)` |\n| `product_id` | `string` | `eq` | `eq(product_id,6837058c-ae42-46db-b3c6-7f01e0c34b40)` |\n| `product_sku` | `string` | `eq` | `eq(product_sku,deck-shoe-001)` |\n| `created_at` | `date` | `eq` / `gt` / `ge`/ `le` / `lt` | `gt(created_at,YYYY-MM-DD)` |\n| `updated_at` | `date` | `eq` / `gt` / `ge`/ `le`/ `lt` | `lt(updated_at,YYYY-MM-DD)` |\n| `external_ref` | `string` | `eq` / `like` | `like(external_ref, 16be*)` |\n| `order_number` | `string` | `eq` / `like` | `like(order_number, 123*)` |\n### Includes\nYou can include related resources with the order response by using the `include` query parameter.\n| Name | Optional | Type | Description | |:-----|:---------|:-----|:------------| | `include` | Optional | `string` | Comma-delimited string of entities that can be included. The information included are `items`, `tax_items`, `custom_discounts`, or `promotions`. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "items" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching orders. See filtering documentation for available operators and attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's orders.", "type": "text/plain" }, "key": "x-moltin-customer-token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0c91586a-d0f2-4f7f-ad10-800ac78d0b61", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "items" }, { "disabled": false, "description": { "content": "The maximum number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "20" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Filter expression for searching orders. See filtering documentation for available operators and attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "A customer token to access a specific customer's orders.", "type": "text/plain" }, "key": "x-moltin-customer-token", "value": "{{customerToken}}" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"07406231-7164-ce32-af68-d7f23bcec21c\",\n \"status\": \"incomplete\",\n \"payment\": \"partially_authorized\",\n \"shipping\": \"unfulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": 2954.1107439287753\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": true\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2346.1624479440648,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 5753.448074806264,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 4324.082318068871,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 2370.7096528872016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 9498.580552120451,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 2078.6776383853644,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 9348.238883535043,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 7186.893282359377,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": true\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"RTh4SiNnlpFMdkp@feiUMQKRWXg.ltp\",\n \"id\": \"0d5ab028-2e2b-0a27-caab-11e091cb3394\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"8a064908-d87f-d2ee-8bc7-0b7f6819c654\"\n },\n {\n \"type\": \"string\",\n \"id\": \"52351bb5-a72a-2c83-41d9-c7335f11c76f\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"fd38145d-cb48-eeb5-eb44-06e8f5a92dc5\"\n },\n {\n \"type\": \"string\",\n \"id\": \"8ffcdfe4-fced-a123-7353-10eedf2a4733\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"d10034e1-237d-f3bb-cdab-dbf018cc599c\"\n },\n {\n \"type\": \"string\",\n \"id\": \"7219a5c3-2ad8-92f5-ced7-7183034dae16\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"089bdf6c-f867-022b-1cb7-5f1e73acd9aa\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"972e7862-28d7-f81c-5c73-2ca4c634ddc3\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"2d049f39-bb6b-d1fb-d0fd-879c526ba41d\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"ab42770c-3ff6-c564-dca6-5b90027243ab\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"f0bba2ba-ac9a-da57-6153-131f63da9444\",\n \"status\": \"incomplete\",\n \"payment\": \"partially_authorized\",\n \"shipping\": \"unfulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": \"string\"\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 3543.2892823323227,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 905.7307945040893,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3103.4790213344922,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 6047.583553648086,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 761.6263119186151,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 8364.52666985393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 9914.587157409,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 4941.877797498027,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": true\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"ZQ--AE1FHm5@RUDHwmDRtAZFcpsS.wp\",\n \"id\": \"bc83a778-82bc-58ea-735e-3bf6d47e608d\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"062bf7c5-7552-dc2a-a232-e83e02e0ca28\"\n },\n {\n \"type\": \"string\",\n \"id\": \"db8fe41a-3953-3837-4edd-d146af2012c2\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"e6674489-02b2-96db-ab50-5bb50cf55cb4\"\n },\n {\n \"type\": \"string\",\n \"id\": \"41884097-88ed-2e3c-3a10-6c899142037d\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"4af4f84b-8203-e3f5-2d64-701670ca886a\"\n },\n {\n \"type\": \"string\",\n \"id\": \"b35939c3-2cd2-375d-d746-a7ac0a68dd20\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"4fb2f452-72a7-a230-78af-2af7d6b107e1\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"008ef790-5d99-d2b4-68e3-1b75d6fd0a79\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"f316fce1-b50b-e8f1-d8a6-53b3a095b5ba\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"63a54a80-57e8-cbf4-3feb-f213b8f3b4dc\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"current\": \"string\",\n \"first\": \"string\",\n \"last\": \"string\",\n \"next\": \"string\",\n \"prev\": \"string\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 1474,\n \"limit\": 7280,\n \"offset\": 6887,\n \"total\": 5283\n },\n \"results\": {\n \"total\": 383\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7aad2f62-5a55-4039-a8c7-7e71ee6296ed", "name": "Get an Order", "request": { "name": "Get an Order", "description": { "content": "Use this endpoint to retrieve a specific order.\n\n### Includes\n\nYou can include related resources with the order response by using the `include` query parameter.\n\n| Name | Required | Type | Description |\n|:----------|:---------|:---------|:------------|\n| `include` | Optional | `string` | Comma-delimited string of entities that can be included. The included options are `items`, `tax_items`, `custom_discounts`, or `promotions`. |", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "items" } ], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3da097d7-dc81-489c-8207-42adbe5b5039", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "items" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"2d32a450-533e-dae4-e61b-ce6009ae8242\",\n \"status\": \"incomplete\",\n \"payment\": \"authorized\",\n \"shipping\": \"fulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 1957.8586099001138\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9914.493777910444,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 6534.581765664636,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3993.132637498735,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 7610.119175361509,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 3109.494570225515,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 1789.1502089884393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 2533.5289689936944,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2689.233629716352,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": false\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"uposf@pmMVltoNOoWzYyDOfnckDycndK.pwxg\",\n \"id\": \"667df9c7-eac5-3728-7d93-f1308b8315da\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"dabf0383-be37-c4a6-2d37-8b43d9aedbb9\"\n },\n {\n \"type\": \"string\",\n \"id\": \"43e1b4a2-419c-3464-5f0f-02ec199da1a3\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"ed5b83c0-99ad-dbd4-0875-dd46853e30cb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"66f21715-c843-404f-1029-c2c7a82bbd57\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"c02555aa-89aa-ad55-bf03-e86b1614e07f\"\n },\n {\n \"type\": \"string\",\n \"id\": \"7afc2bd1-d3fa-ed92-51b0-7ec3c786e0a1\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"709af4a5-4928-e34d-702f-aff150418af8\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"d602ea40-6de7-250e-a872-9370359f4553\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"de887a1b-10cd-4745-be8e-20da6050fec0\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"c087d401-4cb1-e9f9-46d0-fda0815b8ad3\"\n }\n }\n }\n },\n \"included\": {\n \"items\": [\n {\n \"type\": \"string\",\n \"id\": \"842e2744-60df-8624-7e0a-5c8cbaa3a6c8\",\n \"quantity\": 6888.60395358758,\n \"product_id\": \"a7b0c376-3151-a6a3-c172-9358a1245655\",\n \"subscription_offering_id\": \"a9d6bafe-4689-6e1e-bea6-3634a103ded5\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 9436.10000270601,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 9538.241478140813,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2601.156117857546,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"268a9f6e-dc94-2e90-267b-f0dc850f9dab\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 9115\n },\n {\n \"amount\": {\n \"amount\": 1049.5277781388945,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"be973d1c-4295-7709-edd3-0c22f8e715aa\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 3189\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 4626.177841045273,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4574.5675202631155,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 3217.7312688181314,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7930.931882413619,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 2206.7785907573457,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5163.3669421378545,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 9522.257406302158,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 8215.982623078835,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 9980.371197817489,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9652.012103091076,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 1079.2484248731894,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 8478.537585688131,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 4861.473154119789,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9691.801629445676,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 4378.15932345391,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5600.926366436165,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 7756.688467992294,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6644.066801841311,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fafa4065-47c6-f69c-27a3-c632e8a37dbb\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 6701.822971992071\n },\n \"key_1\": {\n \"key_0\": 6486.558347741591,\n \"key_1\": 5191.488692014918,\n \"key_2\": 3961.4102399349063\n },\n \"key_2\": {\n \"key_0\": 8320.853790433574,\n \"key_1\": 9692.944180396233\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 3855.395983711096,\n \"key_1\": 9998.291742750396\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": 8194.368343318545\n },\n \"price\": {\n \"key_0\": 4129.387559264366\n },\n \"relationships\": {\n \"key_0\": \"string\",\n \"key_1\": 1741\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": 6167.408551751856,\n \"key_1\": 4650.914229215042\n },\n \"relationships\": {\n \"key_0\": 589,\n \"key_1\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7759.698488998277,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9240.45897428168,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7675.701091361011,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9905.882121518216,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 6704.724689161119\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 1164.656489770377\n },\n \"key_1\": {\n \"type\": \"string\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"7918a510-c7fd-a9e4-49fe-fbf832a78016\",\n \"quantity\": 7917.876154416516,\n \"product_id\": \"6407c604-e8ef-5603-b0da-eba6f832126c\",\n \"subscription_offering_id\": \"bb7c364c-078b-1a24-37f1-6eccaea236fc\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 8691.048216114037,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 114.68266383086956,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 8890.840721620561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"c8f7622f-8fd9-ad96-d299-d8237d671da8\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 6597\n },\n {\n \"amount\": {\n \"amount\": 3478.3804999638955,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"d0867f69-d731-7b7e-b0f0-a6d217a1cff5\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 8291\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 8686.4633282287,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2383.37801681362,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8858.458934685113,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 92.19540254058688,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 834.1383725656004,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7318.660348167079,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 6362.5041725779965,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4078.552510373854,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 6132.458908267291,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6909.41235690766,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 2769.0804153170266,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 6619.978990433963,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 4396.29986230003,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 8921.262328006758,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9289.302071420389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 7235.773021518968,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 3860.857798083479,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9930.07840323203,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"bc0c3c4b-ace6-1312-d337-a69be9713f1f\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 1321.4463509546538,\n \"key_1\": 9260.620249881651\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 1566.406834004559\n },\n \"meta\": {\n \"key_0\": 7217.275885746026\n },\n \"price\": {\n \"key_0\": 1570,\n \"key_1\": 3476\n },\n \"relationships\": {\n \"key_0\": true,\n \"key_1\": 9276.396649909135,\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": true\n },\n \"meta\": {\n \"key_0\": 9248.328142988285,\n \"key_1\": true\n },\n \"price\": {\n \"key_0\": 9411.304838629463\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 519.5887919374642,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 1557.0726404282964,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": \"string\",\n \"key_1\": 8997.161529532606,\n \"key_2\": \"string\"\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"boolean\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"e474d629-18a9-904e-cd4b-259761cc7098\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 2377.5671907347173,\n \"amount\": 7148\n },\n {\n \"type\": \"string\",\n \"id\": \"e92cfacd-9305-5fdc-4cd8-7e08b3d9d10b\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 5084.716113186627,\n \"amount\": 1707\n }\n ],\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"740a639c-db0e-88c5-c532-5c7d7099c82c\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2342.42409538604,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"9abddc4c-4867-05e9-9432-b76855ffe1f4\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"643f3ead-7c0e-9a35-bc7c-c8e9b90f121d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 4948.603957436144,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"05fbb349-a859-cdaf-59a2-e970f9c0ba01\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"472788b5-72fb-e011-def2-b0b4a42e4d88\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1973-07-06T23:59:28.397Z\",\n \"end\": \"1953-02-04T23:20:02.122Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"0604432c-db06-4ea2-d154-bc3f7d4d48eb\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1962-07-08T07:48:03.909Z\",\n \"end\": \"1981-01-10T15:07:42.183Z\"\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 8083,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"Zemzh02qUKff@SbFvYUEpqDsITKFMmCrbBZwagSw.frr\",\n \"component_product_id\": \"4c337f69-436a-966f-e1d1-221a8d776685\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 2968,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"jQNCVrFzx7vZ@ifzOeYFoPdugGzQD.qg\",\n \"component_product_id\": \"7781c249-5344-218a-4d7d-b44cdcf3cebc\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24e686c7-cd3d-4913-9619-639c8b8688f5", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "items" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Order not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "583a41e6-294e-485f-ae4b-2bf85a73704c", "name": "Update an Order", "request": { "name": "Update an Order", "description": { "content": "You can only update custom data, `shipping`, `shipping_address`, and status of orders. All other settings in the order object are immutable.\n\n This endpoint allows you to:\n\n- **Update an order number and external reference**: You can update an existing order that does not have an `order_number` and `external_ref`, modify the `order_number` and `external_ref` values, or remove them by passing an empty value in the `order_number` and `external_ref` fields.\n- **Cancel an order**: You can cancel an order only if it has not been fulfilled.\n- **Fulfill an order**: You can fulfill a paid order only.\n\n:::caution\n\nYou can update `shipping`, `shipping_address`, and status of an order only if the order is not fulfilled. You can use the refund API to refund an order only if the payment status is `paid`. Canceling an order does not automatically refund a payment. You must refund the orders manually.\n\n:::\n\n:::note\n\n- This request is only accessible to client credentials token users with Seller Admin role.\n- Non client credentials token users cannot access this endpoint. See [Permissions](/docs/authentication/tokens/permissions).\n- The `order_number` will appear as the invoice number in Authorize.net transactions.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"order\",\n \"status\": \"cancelled\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "045c03c0-a9c2-4ce6-8e23-7ec45a0b169d", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"order\",\n \"status\": \"cancelled\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"2d32a450-533e-dae4-e61b-ce6009ae8242\",\n \"status\": \"incomplete\",\n \"payment\": \"authorized\",\n \"shipping\": \"fulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 1957.8586099001138\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 9914.493777910444,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 6534.581765664636,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3993.132637498735,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 7610.119175361509,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 3109.494570225515,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 1789.1502089884393,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 2533.5289689936944,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 2689.233629716352,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": false\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"uposf@pmMVltoNOoWzYyDOfnckDycndK.pwxg\",\n \"id\": \"667df9c7-eac5-3728-7d93-f1308b8315da\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"dabf0383-be37-c4a6-2d37-8b43d9aedbb9\"\n },\n {\n \"type\": \"string\",\n \"id\": \"43e1b4a2-419c-3464-5f0f-02ec199da1a3\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"ed5b83c0-99ad-dbd4-0875-dd46853e30cb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"66f21715-c843-404f-1029-c2c7a82bbd57\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"c02555aa-89aa-ad55-bf03-e86b1614e07f\"\n },\n {\n \"type\": \"string\",\n \"id\": \"7afc2bd1-d3fa-ed92-51b0-7ec3c786e0a1\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"709af4a5-4928-e34d-702f-aff150418af8\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"d602ea40-6de7-250e-a872-9370359f4553\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"de887a1b-10cd-4745-be8e-20da6050fec0\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"c087d401-4cb1-e9f9-46d0-fda0815b8ad3\"\n }\n }\n }\n },\n \"included\": {\n \"items\": [\n {\n \"type\": \"string\",\n \"id\": \"842e2744-60df-8624-7e0a-5c8cbaa3a6c8\",\n \"quantity\": 6888.60395358758,\n \"product_id\": \"a7b0c376-3151-a6a3-c172-9358a1245655\",\n \"subscription_offering_id\": \"a9d6bafe-4689-6e1e-bea6-3634a103ded5\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 9436.10000270601,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 9538.241478140813,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 2601.156117857546,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"268a9f6e-dc94-2e90-267b-f0dc850f9dab\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 9115\n },\n {\n \"amount\": {\n \"amount\": 1049.5277781388945,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"be973d1c-4295-7709-edd3-0c22f8e715aa\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 3189\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 4626.177841045273,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4574.5675202631155,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 3217.7312688181314,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7930.931882413619,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 2206.7785907573457,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5163.3669421378545,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 9522.257406302158,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 8215.982623078835,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 9980.371197817489,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9652.012103091076,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 1079.2484248731894,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 8478.537585688131,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 4861.473154119789,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9691.801629445676,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 4378.15932345391,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5600.926366436165,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 7756.688467992294,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6644.066801841311,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fafa4065-47c6-f69c-27a3-c632e8a37dbb\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 6701.822971992071\n },\n \"key_1\": {\n \"key_0\": 6486.558347741591,\n \"key_1\": 5191.488692014918,\n \"key_2\": 3961.4102399349063\n },\n \"key_2\": {\n \"key_0\": 8320.853790433574,\n \"key_1\": 9692.944180396233\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 3855.395983711096,\n \"key_1\": 9998.291742750396\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": 8194.368343318545\n },\n \"price\": {\n \"key_0\": 4129.387559264366\n },\n \"relationships\": {\n \"key_0\": \"string\",\n \"key_1\": 1741\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": 6167.408551751856,\n \"key_1\": 4650.914229215042\n },\n \"relationships\": {\n \"key_0\": 589,\n \"key_1\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7759.698488998277,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9240.45897428168,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 7675.701091361011,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 9905.882121518216,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 6704.724689161119\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": 1164.656489770377\n },\n \"key_1\": {\n \"type\": \"string\",\n \"value\": true\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": false\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"7918a510-c7fd-a9e4-49fe-fbf832a78016\",\n \"quantity\": 7917.876154416516,\n \"product_id\": \"6407c604-e8ef-5603-b0da-eba6f832126c\",\n \"subscription_offering_id\": \"bb7c364c-078b-1a24-37f1-6eccaea236fc\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 8691.048216114037,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 114.68266383086956,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 8890.840721620561,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"c8f7622f-8fd9-ad96-d299-d8237d671da8\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 6597\n },\n {\n \"amount\": {\n \"amount\": 3478.3804999638955,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"d0867f69-d731-7b7e-b0f0-a6d217a1cff5\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 8291\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 8686.4633282287,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2383.37801681362,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8858.458934685113,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 92.19540254058688,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 834.1383725656004,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7318.660348167079,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 6362.5041725779965,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4078.552510373854,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 6132.458908267291,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6909.41235690766,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 2769.0804153170266,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 6619.978990433963,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 4396.29986230003,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 8921.262328006758,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9289.302071420389,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 7235.773021518968,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 3860.857798083479,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9930.07840323203,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"bc0c3c4b-ace6-1312-d337-a69be9713f1f\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 1321.4463509546538,\n \"key_1\": 9260.620249881651\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 1566.406834004559\n },\n \"meta\": {\n \"key_0\": 7217.275885746026\n },\n \"price\": {\n \"key_0\": 1570,\n \"key_1\": 3476\n },\n \"relationships\": {\n \"key_0\": true,\n \"key_1\": 9276.396649909135,\n \"key_2\": \"string\",\n \"key_3\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": true\n },\n \"meta\": {\n \"key_0\": 9248.328142988285,\n \"key_1\": true\n },\n \"price\": {\n \"key_0\": 9411.304838629463\n },\n \"relationships\": {\n \"key_0\": true\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 519.5887919374642,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 1557.0726404282964,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": \"string\",\n \"key_1\": 8997.161529532606,\n \"key_2\": \"string\"\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"boolean\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ],\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"e474d629-18a9-904e-cd4b-259761cc7098\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 2377.5671907347173,\n \"amount\": 7148\n },\n {\n \"type\": \"string\",\n \"id\": \"e92cfacd-9305-5fdc-4cd8-7e08b3d9d10b\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 5084.716113186627,\n \"amount\": 1707\n }\n ],\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"740a639c-db0e-88c5-c532-5c7d7099c82c\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2342.42409538604,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"9abddc4c-4867-05e9-9432-b76855ffe1f4\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"643f3ead-7c0e-9a35-bc7c-c8e9b90f121d\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 4948.603957436144,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"05fbb349-a859-cdaf-59a2-e970f9c0ba01\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"472788b5-72fb-e011-def2-b0b4a42e4d88\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1973-07-06T23:59:28.397Z\",\n \"end\": \"1953-02-04T23:20:02.122Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"0604432c-db06-4ea2-d154-bc3f7d4d48eb\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1962-07-08T07:48:03.909Z\",\n \"end\": \"1981-01-10T15:07:42.183Z\"\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 8083,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"Zemzh02qUKff@SbFvYUEpqDsITKFMmCrbBZwagSw.frr\",\n \"component_product_id\": \"4c337f69-436a-966f-e1d1-221a8d776685\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 2968,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"jQNCVrFzx7vZ@ifzOeYFoPdugGzQD.qg\",\n \"component_product_id\": \"7781c249-5344-218a-4d7d-b44cdcf3cebc\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f123b450-27b1-484b-a772-bee612e874c6", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"order\",\n \"status\": \"cancelled\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6cff77f-3633-42cd-a342-0521ad910768", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"order\",\n \"status\": \"cancelled\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Order cannot be updated in its current state\",\n \"status\": \"422\",\n \"title\": \"Unprocessable Entity\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "033fc279-11dc-4357-aaad-7479f746bcfb", "name": "Get Order Items", "request": { "name": "Get Order Items", "description": { "content": "Use this endpoint to retrieve order items.\n\n### Includes\n\nYou can include related resources with the order items response by using the `include` query parameter.\n\n| Name | Required | Type | Description |\n|:----------|:---------|:---------|:------------|\n| `include` | Optional | `string` | Comma-delimited string of entities that can be included. The included options are `tax_items`, `custom_discounts`, or `promotions`. |", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "tax_items" } ], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "78f27654-e135-47ad-b089-129cd56d814d", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Comma-delimited string of entities to include (tax_items, custom_discounts, promotions).", "type": "text/plain" }, "key": "include", "value": "tax_items" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"83b92040-c3ca-f024-2f9f-2a679887cdd7\",\n \"quantity\": 3765.5748574006666,\n \"product_id\": \"22e44531-982c-67e9-86fc-cbe8abbe3e89\",\n \"subscription_offering_id\": \"223fae34-bc50-75c4-1a71-1f52b359a58f\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 3725.13642699692,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 6278.543307177038,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 206.49609570565718,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"eb26c904-7dfb-b1b4-5131-935e2a59bc65\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 6799\n },\n {\n \"amount\": {\n \"amount\": 2072.5414911840367,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"909f4381-c7bd-3d2a-2f67-7415c3f7d17f\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 6035\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 1295.2884049773704,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 771.6331375434215,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 7022.755796590461,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 8934.114675298702,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 589.7652427013833,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5575.613183086641,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 82.33620745343507,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 2212.275628262188,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 6020.559779083778,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 553.107851369179,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 690.9398734897154,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 3727.8754567520946,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 7499.5278798427335,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 5075.587127882628,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 3263.6203423607067,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 778.6930397290748,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 8833.961552564606,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 5191.8253534153955,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 6494.445857903399,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 1806.2109363990398,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 8091.544810091586,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"bd26985b-1b5e-6081-9303-c74931574dcf\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 7032.68593054124,\n \"key_1\": 6931.909662909532\n },\n \"key_1\": {\n \"key_0\": 6957.958481953137\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n },\n \"meta\": {\n \"key_0\": 4095\n },\n \"price\": {\n \"key_0\": false,\n \"key_1\": 8005,\n \"key_2\": false\n },\n \"relationships\": {\n \"key_0\": 2249,\n \"key_1\": \"string\",\n \"key_2\": false\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n },\n \"meta\": {\n \"key_0\": true,\n \"key_1\": false\n },\n \"price\": {\n \"key_0\": false,\n \"key_1\": 3889\n },\n \"relationships\": {\n \"key_0\": true,\n \"key_1\": 8441.905023255376\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 4626.089526504756,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 3694.6836764104705,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 2195.1533106070965,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 7240.361151300407,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 5220.270643958451,\n \"key_1\": 8323\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"boolean\",\n \"value\": \"string\"\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"da00fd4a-3d74-9a8b-b403-397fbb76e065\",\n \"quantity\": 1720.9356331099789,\n \"product_id\": \"c458189d-c6db-2303-5eb7-e830494cf017\",\n \"subscription_offering_id\": \"ff51c5d6-eca1-0e66-9b70-782332636377\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 8880.622303639191,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"value\": {\n \"amount\": 1060.6428356655595,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 6039.890982005354,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"9ab623d2-ef1e-5b6b-268b-8b6f58a27d87\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9370\n },\n {\n \"amount\": {\n \"amount\": 14.64719128955183,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"d8c976c4-116e-06d3-7a22-375830fd77ff\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 1892\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 7836.6744801953755,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4229.854247658531,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 3711.7335812909723,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 182.56081288162696,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 1276.0377276669653,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5538.411605142246,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 8924.595459539678,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7702.99574374584,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 3268.425866694016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6459.268394862641,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 5649.974927233581,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 9878.777455114614,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 5373.377476263097,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 5588.862138097834,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_3\": {\n \"amount\": 2196.1822339204386,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 4509.046960846857,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 2436.0765711313957,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 5153.380848294933,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 9509.319212986735,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"b4591174-ab4a-69e3-3842-96c5acfcf947\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 8416.628581342804\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 8630,\n \"key_1\": 5438,\n \"key_2\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": 9807.651056456118\n },\n \"price\": {\n \"key_0\": false\n },\n \"relationships\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"meta\": {\n \"key_0\": true,\n \"key_1\": false,\n \"key_2\": \"string\"\n },\n \"price\": {\n \"key_0\": 6463.180378334509\n },\n \"relationships\": {\n \"key_0\": \"string\"\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 752.8719791322968,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 7857.727675538433,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 6985.750944282041,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 799.2510931222351,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": \"string\",\n \"key_1\": false,\n \"key_2\": true,\n \"key_3\": 7348.340833061519\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": 7613.874297663381\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ],\n \"included\": {\n \"tax_items\": [\n {\n \"type\": \"string\",\n \"id\": \"93e7c52e-381d-f018-5c6e-e81cb2bb83a8\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 6977.783044140582,\n \"amount\": 4212\n },\n {\n \"type\": \"string\",\n \"id\": \"4a8fc512-0011-c28a-6159-82bb5e117dbd\",\n \"jurisdiction\": \"string\",\n \"code\": \"string\",\n \"name\": \"string\",\n \"rate\": 3599.7916085955685,\n \"amount\": 8027\n }\n ],\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"a53d1f2c-37fe-9472-25ea-e705b6486042\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 2554.211795242192,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"f8194cb8-4e94-bef3-1c75-ed7af99ca997\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"3deee898-efd1-c54e-e69a-8bda1b64fbfd\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 5857.403266638841,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"eae1b74f-e913-5c19-5bc9-105aa3d97dc5\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"41a1c5e2-3e5a-da5e-f17f-67da8333dea6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1960-05-05T05:09:48.991Z\",\n \"end\": \"1953-04-27T20:29:24.922Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"4b124f89-be82-53ab-0b7c-609f197b80a7\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2021-03-04T15:07:45.320Z\",\n \"end\": \"1957-02-16T21:05:30.021Z\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a9a971a6-8d2f-445d-a84c-f31fc36e4343", "name": "Anonymize Orders", "request": { "name": "Anonymize Orders", "description": { "content": "You can anonymize an order when it is fulfilled, canceled, or fully refunded.\n\nWhen anonymization is successful, Personal Identifiable Information such as customer details, `shipping_address`, and `billing_address` are replaced with *.\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_ids\": [\n \"{{orderID}}\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6661d382-afad-4b5d-84ae-5f3f6d1cb0c7", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "orders", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_ids\": [\n \"{{orderID}}\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"e147afcf-97fe-0257-e009-6d87b6df2411\",\n \"status\": \"incomplete\",\n \"payment\": \"partially_paid\",\n \"shipping\": \"unfulfilled\",\n \"anonymized\": true,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"float\",\n \"value\": false\n },\n \"key_1\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 2056.1916867669192,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 3214.269858259702,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9372.689717362695,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 4965.527460257519,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 1385.3803317565648,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 830.6038730119369,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 1492.0332755751774,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 4171.728010937519,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": true\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"5HP3nEbjix@VHGvLKBfNScCPqDHAMvswwdfWoBsxo.jll\",\n \"id\": \"cfa87925-b392-4c60-0b38-a97e53beb35a\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2cea9e6b-cb75-e1de-af5b-1d8cccb31785\"\n },\n {\n \"type\": \"string\",\n \"id\": \"25c217c3-2063-b52d-cba5-becb52a66dd3\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"b1e66d64-f619-74b7-dc15-070b5bd769fc\"\n },\n {\n \"type\": \"string\",\n \"id\": \"bd677296-5f46-e4bf-cfa2-0c0cdd2b7568\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"b558d383-0b25-16cd-37de-63977b439ad5\"\n },\n {\n \"type\": \"string\",\n \"id\": \"2d8a0c5a-57b3-b171-20de-140ef03bbfdb\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"da79d729-82fb-5cce-bde6-d5033fce4891\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"477bcf33-8000-1b29-c153-1a03e629d305\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"f54bad96-e562-456b-5f55-c3123d987356\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"232aac2f-f630-d30a-bc8d-2e47c34eeb16\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"order_number\": \"string\",\n \"external_ref\": \"string\",\n \"id\": \"db9ce032-9f09-7805-7414-abbdb513718e\",\n \"status\": \"cancelled\",\n \"payment\": \"authorized\",\n \"shipping\": \"unfulfilled\",\n \"anonymized\": false,\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"boolean\",\n \"value\": true\n }\n },\n \"links\": {},\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"fully_paid_at\": \"string\"\n },\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 1568.3797738732874,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 9686.170319207597,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 1868.4093242752954,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 800.1235653484051,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 9377.447665390091,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 8509.647083066297,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 3779.6710589086138,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 5915.247024699075,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"is_manual\": true\n },\n \"billing_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\"\n },\n \"contact\": {\n \"email\": \"string\",\n \"name\": \"string\"\n },\n \"customer\": {\n \"name\": \"string\",\n \"email\": \"u1Ci@gVWe.sbu\",\n \"id\": \"9ed40f94-59d4-43f7-98cf-4201a0eb702b\"\n },\n \"shipping_address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"relationships\": {\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"67215d11-de58-b9e0-acc7-22c3e6d163ca\"\n },\n {\n \"type\": \"string\",\n \"id\": \"0d44f3bc-34f8-9868-a99a-365b8bd7c012\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"9e7d40ee-d2da-db0f-63a8-2d22cc5f438f\"\n },\n {\n \"type\": \"string\",\n \"id\": \"26250cb5-a291-c0b6-bb80-74291e8032e4\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"bf969929-0975-99b0-5678-58ca7e957130\"\n },\n {\n \"type\": \"string\",\n \"id\": \"408bcd55-1c7c-7898-a06c-9bbd8f3bce2f\"\n }\n ]\n },\n \"customer\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"87808e28-a9b3-eb1b-4433-62fe825cb527\"\n }\n },\n \"account\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"0b4e0cf2-de0b-96f3-bc14-018819151974\"\n }\n },\n \"account_member\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"30997297-3b2f-131b-4c58-8592e80f15b1\"\n }\n },\n \"store\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"41825f5f-eabb-2715-9b7a-4112810ebff7\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f09e1ba-20ac-418e-8275-b181854a9a5e", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"order_ids\": [\n \"{{orderID}}\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Order has status: order:incomplete, payment:unpaid, shipping:unfulfilled; only fulfilled or refunded or cancelled orders may be anonymized\",\n \"status\": 422,\n \"title\": \"Could not anonymize orders\",\n \"meta\": {\n \"order_id\": \"496c29a1-6e7a-4ab6-a4e7-d1ec9a08b85e\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2ec1d903-530c-4154-96ff-80b65002773f", "name": "Confirm Order", "request": { "name": "Confirm Order", "description": { "content": "Use this endpoint to confirm an order. Confirming an order finalizes it and makes it ready for processing.\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order to confirm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "7685cb4a-8aec-4536-ae23-70a988fe5f5b", "name": "Order confirmed successfully", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order to confirm.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a51aa317-791b-144d-e347-fed6313d25b0\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 5896.841569061635,\n \"refunded_amount\": 1988.875938987915,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": \"string\"\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"503752f4-a9ef-8774-2f3e-e28e5f4195c7\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 9017.174856559162,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6752.99714997146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8e04c53-13f1-45b5-b71f-2449d4912ebf", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order to confirm.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1c62249-3a3b-40c3-85e8-49ff64074451", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order to confirm.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Order not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49ff02d8-4270-44fd-b57a-fbc94eab3367", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order to confirm.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Order cannot be confirmed in its current state\",\n \"status\": \"422\",\n \"title\": \"Unprocessable Entity\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Payments", "description": "When you [checkout](/docs/api/carts/checkout) a [cart](/docs/api/carts/cart-management), an unpaid [order](/docs/api/carts/orders) is returned. You can process the payment for the order though a payment gateway.\n\n:::note\n\n- You need to configure and enable a payment gateway before you can accept payments for orders.\n- Configure your store to use [Manual Gateway](/docs/api/payments/update-manual-gateway) to process payments if the order total is zero or the payment is through non-supported payment providers.\n- There are a number of actions that happen to your inventory when checking out and paying for an order. For more information, see [Inventory](/docs/api/pxm/inventory/inventories-introduction).\n- We recommend to wait until the payment confirmation process is fully completed before proceeding with any additional updates to the order. Making simultaneous updates to the same entity immediately after payment confirmation can lead to a race condition. To learn more information on handling parallel calls to API objects, see [Parallel Calls to API Objects](/guides/Getting-Started/api-contract#parallel-calls-to-api-objects).\n\n:::\n\n### Payment Methods\n\nDepending on the chosen gateway, you may or may not have access to capture funds immediately or authorize for later payment.\n\nTo make a partial payment in Postman through any payment gateway, specify the desired payment amount in the amount field within the request body. To learn about Split Payments, see the [Split Payments](/docs/api/payments/payment-gateways-introduction#split-payments) section.\n\n#### Purchase\n\nThe simplest method is purchase. The gateway attempts to charge the customer immediately, and the result of the attempt is returned.\n\nYou can partially pay funds using purchase method. The gateway attempts to charge the customer immediately, and the payment status for an order shows `partially_paid`.\n\nWhen you Get an order, you can see the following fields in the `meta` object:\n\n- `balance_owing`: Specifies the outstanding funds required to complete an order. It considers all complete or pending transactions, including authorized, paid, and captured transactions. (`balance_owing` = order total - `authorized` amount - `paid` amount).\n- `paid`: Specifies the total amount of purchased or captured transactions.\n- `authorized`: Specifies the total amount of completed or pending authorized transactions for an order.\n\n#### Authorize\n\nYou can `authorize` a payment so funds can later be captured when an item is dispatched or restocked.\n\nYou can partially pay for an order using `authorize` payment method so that the order is `partially_authorized`. The transaction must be complete for the order status to be `partially_authorized`.\n\nFor more information about order and payment statuses for split payments, see [Split Payments](/docs/api/payments/payment-gateways-introduction#split-payments).\n\n#### Capture\n\nAfter authorizing a transaction, you have to capture the authorized funds.\n\n:::note\n\nWe recommend capturing payments several hours to days after the authorization to mitigate risks of fraud and chargebacks. When you sell digital goods that are delivered immediately, we recommend using a single purchase call instead of separate authorize and capture calls.\n\n:::\n\nAfter the payment is `partially_authorized`, you must `capture` the authorized transaction later. Once you capture the authorized transactions, the order payment status will change to `partially_paid`.\n\n#### Refunds\n\nYou can use either the Refund through Composable Commerce or use the Mark as Refunded capability, or a combination of both capabilities.\n\nFor more information about refund for split payments, see [Refund a Payment](/docs/api/carts/refund-a-transaction).\n\n#### Refund through Composable Commerce\n\nYou can start a full or partial refund to a supported payment provider directly from Commerce Manager or the API. When you start the refund process, the refund request is sent to the payment gateway. You no longer have to log on to your payment gateway's console to process the refund.\n\nWhen you process a refund, use the refund endpoint to pass the refund amount. If you don't pass an amount, the refund is processed as Mark as refunded. For more information, see the Mark as Refunded section.\n\nEach time a partial refund is triggered, the transaction.updated event is generated and updated with refunded.amount. The `order.updated` event is also triggered. The `order.refunded` event generates when the full amount is refunded.\n\n\n#### Mark as Refunded\n\nYou can use your payment gateway's console to process a refund. Process the refund first in the payment gateway and then use the **Mark as Refunded** capability in Composable Commerce to complete the process.\n\nWhen an order is **Marked as refunded**, the payment status `order.payment.status` is set to `refunded`. In this case, the `order.updated`, `transaction.updated` and `order.refunded` events are generated.\n", "item": [ { "id": "d4690b7d-01d5-4e70-b674-cf7fed1026e5", "name": "Create Stripe Payment Intent for a Cart", "request": { "name": "Create Stripe Payment Intent for a Cart", "description": { "content": "The Cart Payment Intent feature enables the creation of a Stripe Payment Intent specifically tied to a shopping cart and its subsequent order. This allows Payment Intent users to track payment details from the cart stage and seamlessly maintain consistency in payment information throughout the order stage. Using these features, you can create Payment Intents for their carts, update Payment Intents with final cart details, and synchronize Payment Intents from Stripe to Commerce.\n\n:::note\n\n- Typically, in Commerce, inventory is allocated at the time of payment initiation after an order is created. However, in the case of Cart Payment Intent, information about the payment is received only upon synchronizing the order from Stripe to Commerce. This may happen after the payment is completed. Therefore, there might be a delay between the payment made and allocation, increasing the chance of paying for items that are not in stock.\n- There are certain fields you can choose to set up when [creating a payment intent](https://stripe.com/docs/api/payment_intents/create). However, if you decide to update a payment intent, the available options may not be the same as those allowed while creating a payment intent. See [updating a payment intent](https://stripe.com/docs/api/payment_intents/update).\n\n:::\n\nThe following steps outline the workflow associated with the Payment Intent:\n\n1. [Add items to cart](/docs/api/carts/manage-carts#add-custom-item-to-cart).\n1. [Create a Payment Intent for the cart](/docs/api/carts/create-cart-payment-intent). The Payment Intent is created in Stripe, reflecting the cart and transaction details, including currency, amounts, payment type, and any optional Stripe details. The Payment Intent ID is generated and linked to the cart.\n1. [Update a Payment Intent](/docs/carts-orders/update-cart-payment-intent). This step is optional but becomes necessary when there are changes in the cart details at the time of payment. It ensures the Payment Intent accurately reflects the current cart details when processing the payments on the front end.\n1. [Checkout the cart](/docs/api/carts/checkout). An unpaid order is created, and the Payment Intent ID is linked to the order.\n1. [Confirm the order](/docs/carts-orders/confirm-an-order). This is important because after checkout, it is essential to confirm the Payment Intent and synchronize it with Commerce. This results in a corresponding transaction and change in order statuses in Commerce. Additionally, the Payment Intent ID is removed from the order once it is linked via the transaction.\n\n### Best Practices\n\nWe recommend you follow these practices to maintain consistency and accuracy when using Cart Payment Intent.\n\n- After checkout, we recommend clearing the shopping cart. You can achieve this using a [Delete a cart](/docs/api/carts/delete-a-cart) endpoint or [Update a cart](/docs/api/carts/update-a-cart) to remove the Payment Intent ID. This helps to avoid potential issues where subsequent checkouts for the same cart might unintentionally use the previous Stripe Payment Intent ID.\n- If it is not reasonable to clear the cart immediately after checkout due to several subsequent, duplicate checkouts to the same cart, ensure that you only synchronize the Payment Intent when finalizing the order. Each order confirmation is unaware of the others, and syncing Payment Intent IDs for each confirmation can lead to duplicate transactions in Commerce. In other words, if you synchronize Payment Intents for earlier versions of a repeated checkout, you'll end up with multiple orders from the same cart, each having transactions linked to the same Payment Intent.\n- To pay the entire amount at once, use the [Update Cart Payment Intent](/docs/carts-orders/update-cart-payment-intent) endpoint to update the Stripe Payment Intent with the final cart details when preparing to take the payment. Doing so, ensures that the Payment Intent accurately reflects the current cart details when processing payments on the front end. We do not recommend calling the [Update Cart Payment Intent](/docs/carts-orders/update-cart-payment-intent) for each individual change in the cart, as this can lead to more requests and may slow down the front-end performance.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The universally unique identifier of the cart for which you want to create a payment intent.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"elastic_path_payments_stripe\",\n \"method\": \"purchase\",\n \"options\": {\n \"automatic_payment_methods\": {\n \"enabled\": true\n },\n \"receipt_email\": \"john@example.com\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c6f1beee-2f22-4f99-bdd3-53f6d2b87273", "name": "Payment Intent created successfully.", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The universally unique identifier of the cart for which you want to create a payment intent.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"elastic_path_payments_stripe\",\n \"method\": \"purchase\",\n \"options\": {\n \"automatic_payment_methods\": {\n \"enabled\": true\n },\n \"receipt_email\": \"john@example.com\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"BYW@fvtPQHikMlhvFheliuFLuqyQXLFPeXcB.mt\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": 822.6772421098926\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 126.79575312376734\n }\n },\n \"snapshot_date\": \"1984-05-06T14:31:35.698Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7724.690250418494,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 965.6893846416992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9240.72236121114,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 188.6342658542728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 4122.139928207081,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8153.970412608016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 8167.249846653129,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2122,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 1393.0676428419474,\n \"key_1\": 5865,\n \"key_2\": false\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 2964,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 6458,\n \"key_3\": 9043.797956152996\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4626,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\"\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 955,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"57c7ca77-1c04-de46-8283-92537a5691fb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"03cbbace-aba2-d8fe-25b8-0cb4e786d75a\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"cb813261-ffc1-6204-012e-55cc805858fe\"\n },\n {\n \"type\": \"string\",\n \"id\": \"07a16b25-827c-ba50-0486-c7de1457ae77\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7e8a5c67-b7b2-6d1d-81ab-d4af345edff0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"54f4444f-9f2b-c23d-cb0d-037e11213487\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2bb549af-f621-257f-f762-46f4d8d8286b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"6b5cfc90-a884-4bf5-eee9-7ff40bb0efcc\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"3254f8bd-e55f-3d7e-a366-007cbd64bc6b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"e1272995-876e-86b5-5724-9856596ffdee\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"6f41b966-482a-3900-d8ec-2fdcef590adf\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 6175.651459105089,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"599189db-6f15-3977-ec51-8fb379d98eff\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"0d0ac6bf-1a9e-6244-5021-e01c8de37428\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 703.8131625745225,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"8713c39d-7f57-534b-8451-6d15fff0667e\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"7d28230f-b33c-99b1-0427-67677ee6f2e6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1977-10-28T16:57:46.835Z\",\n \"end\": \"1994-11-29T00:54:35.861Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"a54245b5-921a-05b3-ea7d-c6a36c072882\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2005-03-24T22:56:18.880Z\",\n \"end\": \"1976-08-30T19:13:41.495Z\"\n }\n ]\n },\n \"meta\": {\n \"payment_intent\": {\n \"key_0\": \"string\"\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"9jC5C@kYJCTLLKKXzXfEvkHoyh.ytaf\",\n \"component_product_id\": \"4f414aa9-0189-8467-15f8-839642991de7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 7590,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"hcA@vcvu.dulp\",\n \"component_product_id\": \"5f7524f1-86a7-57ab-1ae4-c6483195beea\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ebd349d8-cd2f-4522-84c2-fdf09186e078", "name": "Payments", "request": { "name": "Payments", "description": { "content": "Depending on the payment gateway, you may have access to different transaction types such as capturing funds immediately or authorizing them for later. For more information, see [Payments](/docs/api/carts/payments).\n\nThe following types of payment methods are available depending on the payment gateway:\n\n- `purchase`: This is the simplest method. The gateway attempts to charge the customer immediately.\n- `authorize`: This method authorizes a payment so that funds can be captured later, for example, when an item is dispatched or restocked.\n- `purchase_setup`: This method prepares the system for a purchase by verifying payment details without actually charging the customer. For example, a customer adds items to their cart and proceeds to checkout. Before finalizing the purchase, the system runs `purchase_setup` to confirm all payment details, but no funds are transferred until the customer confirms the order.\n- `authorize_setup`: This method prepares the system for an authorization-only transaction. This process holds the necessary funds but does not transfer them, ensuring that the customer has sufficient balance for the transaction. It sets up the conditions for a future capture of the authorized funds. For example, a customer places a pre-order for a product that will ship in two weeks. The merchant uses `authorize_setup` to prepare for the payment authorization. This holds the customer's funds to ensure they can cover the purchase but waits to capture the payment until the product ships. This ensures that payment is secured but not collected prematurely.\n\n:::note\n\nSplit payments can be performed using any methods for any gateway.\n\n- You can partially pay funds using `purchase` method. The gateway attempts to charge the customer immediately, and the payment status for an order will show `partially_paid`\n- You can partially pay for an order using `authorize` method where the order will be marked as `partially_authorized`. The transaction must be completed for the order status to be `partially_authorized`.\n- A `purchase_setup` method allows verification of payment details for partial payments without transferring funds until the customer confirms the full order.\n- An `authorize_setup` method can be used to hold a partial amount of the total funds, ensuring the customer has enough balance for a future capture.\nUntil a payment is made neither `purchase_setup` nor `authorize_setup` affects the payment statuses, and the order remains unpaid. For more information about order and payment statuses for split payments, see [Split payments](/docs/api/payments/payment-gateways-introduction#split-payments).\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The Universally Unique Identifier (UUID) of the order you want to pay for.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"stripe_payment_intents\",\n \"method\": \"authorize\",\n \"payment\": \"string\",\n \"amount\": 8559.103485294137,\n \"options\": {\n \"shopper_reference\": \"string\",\n \"recurring_processing_model\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dcbc81f2-1319-454f-b3c8-fcdfb87be5a6", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The Universally Unique Identifier (UUID) of the order you want to pay for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"stripe_payment_intents\",\n \"method\": \"authorize\",\n \"payment\": \"string\",\n \"amount\": 8559.103485294137,\n \"options\": {\n \"shopper_reference\": \"string\",\n \"recurring_processing_model\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a51aa317-791b-144d-e347-fed6313d25b0\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 5896.841569061635,\n \"refunded_amount\": 1988.875938987915,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": \"string\"\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"503752f4-a9ef-8774-2f3e-e28e5f4195c7\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 9017.174856559162,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6752.99714997146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ddce87a-1eb5-4bb0-8e28-1e1c7e39e0aa", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The Universally Unique Identifier (UUID) of the order you want to pay for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"stripe_payment_intents\",\n \"method\": \"authorize\",\n \"payment\": \"string\",\n \"amount\": 8559.103485294137,\n \"options\": {\n \"shopper_reference\": \"string\",\n \"recurring_processing_model\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90e7bacf-bd28-4629-b8ec-7404f7e40619", "name": "Conflict", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The Universally Unique Identifier (UUID) of the order you want to pay for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"stripe_payment_intents\",\n \"method\": \"authorize\",\n \"payment\": \"string\",\n \"amount\": 8559.103485294137,\n \"options\": {\n \"shopper_reference\": \"string\",\n \"recurring_processing_model\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a5d3a87-eda7-4543-97a7-b5d936e2f928", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The Universally Unique Identifier (UUID) of the order you want to pay for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"stripe_payment_intents\",\n \"method\": \"authorize\",\n \"payment\": \"string\",\n \"amount\": 8559.103485294137,\n \"options\": {\n \"shopper_reference\": \"string\",\n \"recurring_processing_model\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2a413c5-8327-4fb2-84ec-71ca6f0bbb3d", "name": "Confirm Payment", "request": { "name": "Confirm Payment", "description": { "content": "Confirm Payment serves as a mechanism to synchronize transaction information from the third-party payment provider back to our system. This ensures that Composable Commerce accurately reflects the values from the payment provider.\n\n### Handling 3D Secure Validations for Stripe Payments\n\nFor Stripe Payments requiring 3D Secure validation, the transaction response will include the `client_parameters` object, which provides credentials to support validation of these payment requests on the payment provider's side. We recommend using the Stripe's client libraries to manage these 3D Secure validations. Once the validation succeeds, proceed with a confirmation request to sync the validated transaction into Composable Commerce and continue with the payment process.\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "transactionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e095aa33-c728-428c-a3d3-4940a944734d", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a51aa317-791b-144d-e347-fed6313d25b0\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 5896.841569061635,\n \"refunded_amount\": 1988.875938987915,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": \"string\"\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"503752f4-a9ef-8774-2f3e-e28e5f4195c7\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 9017.174856559162,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6752.99714997146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52df3ece-5a88-4e63-9321-0f2865ae57ad", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d186bc7-ecc2-4e66-a7d6-6a405b794348", "name": "Capture a Transaction", "request": { "name": "Capture a Transaction", "description": { "content": "Use this endpoint to capture a previously authorized payment. In this step, you can also pass in a custom reference, such as the payment reference from your chosen gateway.", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "capture" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "transactionID", "disabled": false, "description": { "content": "(Required) The UUID of the transaction to capture.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {\n \"soft_descriptor\": \"string\",\n \"note_to_payer\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "61f108bf-9206-4765-bce1-b19d75de1014", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "capture" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The UUID of the transaction to capture.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {\n \"soft_descriptor\": \"string\",\n \"note_to_payer\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a51aa317-791b-144d-e347-fed6313d25b0\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 5896.841569061635,\n \"refunded_amount\": 1988.875938987915,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": \"string\"\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"503752f4-a9ef-8774-2f3e-e28e5f4195c7\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 9017.174856559162,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6752.99714997146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f04b38e2-b88c-4d93-a0ee-7c85e4d190da", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "capture" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The UUID of the transaction to capture.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {\n \"soft_descriptor\": \"string\",\n \"note_to_payer\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2505d2a2-3c8a-4945-bd42-aa5c2e847843", "name": "Refund a Transaction", "request": { "name": "Refund a Transaction", "description": { "content": "There are two ways to refund; through your payment gateway and mark it refunded in Commerce Manager, or directly through Commerce Manager or API.\n\n* Mark as Refunded: You can manually mark a transaction as refunded. Before you can mark the order as refunded, you need to handle the actual refund on your side with your payment provider. Mark as Refunded is a full refund made to the transaction.\n* Refund through Composable Commerce: You can process a full or partial refund to a supported payment provider directly from Commerce Manager or API by providing the refund amount. When you start the refund process, the request is directly sent to the payment gateway.\n\n:::caution\n\nIf you use manual gateway for partial or full refund, you need to handle the actual refund on your side with your payment provider.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "transactionID", "disabled": false, "description": { "content": "(Required) The UUID of the transaction you want to refund.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": 1192.7246213005383,\n \"options\": {\n \"note\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d7de2ccc-bb74-417f-9abb-54a87dbdb6b3", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The UUID of the transaction you want to refund.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": 1192.7246213005383,\n \"options\": {\n \"note\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a51aa317-791b-144d-e347-fed6313d25b0\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 5896.841569061635,\n \"refunded_amount\": 1988.875938987915,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": \"string\"\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"503752f4-a9ef-8774-2f3e-e28e5f4195c7\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 9017.174856559162,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6752.99714997146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31664b5c-d943-433d-87e6-717845441455", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The UUID of the transaction you want to refund.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": 1192.7246213005383,\n \"options\": {\n \"note\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5d7f038-311e-442c-b607-69002b454fae", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The UUID of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The UUID of the transaction you want to refund.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": 1192.7246213005383,\n \"options\": {\n \"note\": \"string\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Transaction cannot be refunded in its current state\",\n \"status\": \"422\",\n \"title\": \"Unprocessable Entity\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6122447f-7f3a-408a-a264-09864a48d08a", "name": "Get Order Transactions", "request": { "name": "Get Order Transactions", "description": { "content": "Get order transactions", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d9f31b45-891d-461d-a0e3-61ca791afff3", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"d05713af-6224-c0ce-252f-ba57bc696eb3\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"adyen\",\n \"amount\": 6583.005572809857,\n \"refunded_amount\": 1441.666803777879,\n \"currency\": \"string\",\n \"transaction_type\": \"capture\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n },\n \"capture_mechanism\": \"automatic\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"2b0bc80f-5aea-fa22-55a4-df48e41e2531\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 7615.594825090293,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 6244.5234631413205,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n },\n {\n \"id\": \"19b53a33-052e-3503-27fb-062374581bf3\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"manual\",\n \"amount\": 6632.402518207148,\n \"refunded_amount\": 3307.5206028016723,\n \"currency\": \"string\",\n \"transaction_type\": \"purchase\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": 4965,\n \"key_1\": true,\n \"key_2\": 4033\n },\n \"capture_mechanism\": \"automatic\",\n \"refund_mechanism\": \"manual\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"963b24b5-d6fd-b7d3-bb11-7aa1276b4e3b\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 1921.5944312441313,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 621.8176670850229,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8117eab6-485a-40b4-bda3-a5b3be19e78b", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Request could not be processed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b89f21d-7864-4cc3-b095-5d965c8a8360", "name": "Get a Transaction", "request": { "name": "Get a Transaction", "description": { "content": "Retrieves a transaction", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order that you require transactions for.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "transactionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "be1e35bf-c80b-4b02-b385-6436ab37133e", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order that you require transactions for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"94e4fb0c-ae6e-21bc-6de3-cc1915d5a77c\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"cyber_source\",\n \"amount\": 7705.393857430751,\n \"refunded_amount\": 4772.056605310761,\n \"currency\": \"string\",\n \"transaction_type\": \"refund\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": false\n },\n \"capture_mechanism\": \"automatic\",\n \"refund_mechanism\": \"automatic\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"58e85291-42a2-2684-12c0-4a0c5b0a9c20\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 6698.716823990303,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 4593.901205032928,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b245cb75-7ae8-4ae4-b5a6-ee6e9d794052", "name": "Cancel a Transaction", "request": { "name": "Cancel a Transaction", "description": { "content": "Use this endpoint to cancel or void a pending or authorized transaction. The transaction can be canceled or voided when it is in `pending` and `completed` statuses.\n\n:::caution\n\nThis endpoint works only for Stripe and PayPal and does not work for manual gateway.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "transactionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction to be canceled or voided.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {},\n \"reason\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b068900c-9c65-44bf-ab5d-9ba556c3447e", "name": "200", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction to be canceled or voided.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {},\n \"reason\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"1ac7d3f9-0c15-bec8-6eb8-52d91eb5d899\",\n \"reference\": \"string\",\n \"name\": \"string\",\n \"custom_reference\": \"string\",\n \"gateway\": \"stripe_payment_intents\",\n \"amount\": 1139.7527547335606,\n \"refunded_amount\": 4124.735907324762,\n \"currency\": \"string\",\n \"transaction_type\": \"purchase\",\n \"type\": \"string\",\n \"status\": \"string\",\n \"payment_details\": {\n \"detailed_status\": \"string\"\n },\n \"payment_intent\": {\n \"key_0\": false,\n \"key_1\": false,\n \"key_2\": true\n },\n \"capture_mechanism\": \"manual\",\n \"refund_mechanism\": \"automatic\",\n \"client_parameters\": {\n \"redirect_url\": \"string\",\n \"secret\": \"string\",\n \"token\": \"string\"\n },\n \"next_actions\": [\n \"string\",\n \"string\"\n ],\n \"relationships\": {\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"82e00212-1540-26bf-7c59-4565218cd03b\"\n }\n }\n },\n \"meta\": {\n \"display_price\": {\n \"amount\": 6764.695877537228,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"display_refunded_amount\": {\n \"total\": {\n \"amount\": 7518.837573179213,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44c5a0ed-acea-4b42-afdb-780b01732e53", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "transactions", ":transactionID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the order.", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction to be canceled or voided.", "type": "text/plain" }, "type": "any", "value": "string", "key": "transactionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"options\": {},\n \"reason\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom Discounts", "description": "With custom discounts, you can allow your shoppers to apply discounts from external services to their purchases. To apply custom discounts to carts and cart items, you need to set `custom_discounts_enabled` field to `true` in your [Cart Settings](/docs/api/carts/put-v-2-settings-cart).\n\nYou cannot add custom discounts to an empty cart.\n\n:::caution\n\n- You can apply up to five custom discounts to cart and cart item.\n- The stores that use [simple calculation method](/guides/How-To/Carts/calculate-totals) do not support custom discounts.\n\n:::\n", "item": [ { "id": "efc1ea19-df27-4d30-be00-974a93994af4", "name": "Bulk Add Custom Discounts to Cart", "request": { "name": "Bulk Add Custom Discounts to Cart", "description": { "content": "The default value for custom discounts on both the cart and cart items is set to 5 if this parameter is not configured in the store. To verify the custom discount limit value, call [Get all settings](/docs/api/settings/get-v-2-settings) endpoint.\n\nTo increase the custom discount value, contact [Elastic Path Support team](https://support.elasticpath.com/hc/en-us).\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the system generated ID for the cart that the shopper created.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"amount\": 1742.372009987061,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"9a5fc27e-1d53-6baf-844f-266f0cc3d479\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"4fdf9331-f0c0-eec4-3719-85cd68e70ce8\"\n }\n }\n }\n },\n {\n \"amount\": 9528.415012008354,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"4f600188-f4cb-94c8-a32e-38ca56c16e7a\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"ee15356f-e2e2-1c93-e49c-70bfebb81103\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "229b28e0-d67f-444c-8a2e-c7bfab623c13", "name": "201", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the system generated ID for the cart that the shopper created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"amount\": 1742.372009987061,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"9a5fc27e-1d53-6baf-844f-266f0cc3d479\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"4fdf9331-f0c0-eec4-3719-85cd68e70ce8\"\n }\n }\n }\n },\n {\n \"amount\": 9528.415012008354,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"4f600188-f4cb-94c8-a32e-38ca56c16e7a\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"ee15356f-e2e2-1c93-e49c-70bfebb81103\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"amount\": 8723.2266131327,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"27099d6d-bea0-9969-e7c2-6ba73e76382a\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ad72d75f-84e0-6f26-3628-067ecd36afb7\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"e9hdsc@BuvMlkcloqSeVNZVKkgmObuMidSXKoO.kua\",\n \"component_product_id\": \"49e8986d-5bc9-5e58-3f01-c4965f8167a7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"RRTHnyISKrjI@drNWsxAcQf.iuq\",\n \"component_product_id\": \"1e8d0937-7f61-1a27-bd9c-84b0ac83ae10\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5319a0af-c136-49fc-b2a5-e280bde18d23", "name": "Could not apply custom discount", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the system generated ID for the cart that the shopper created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"amount\": 1742.372009987061,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"9a5fc27e-1d53-6baf-844f-266f0cc3d479\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"4fdf9331-f0c0-eec4-3719-85cd68e70ce8\"\n }\n }\n }\n },\n {\n \"amount\": 9528.415012008354,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"4f600188-f4cb-94c8-a32e-38ca56c16e7a\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"ee15356f-e2e2-1c93-e49c-70bfebb81103\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "Custom discounts not enabled for this cart", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7463aae9-6497-4056-8060-863a2577d3d7", "name": "Could not apply custom discount", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the system generated ID for the cart that the shopper created.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"amount\": 1742.372009987061,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"9a5fc27e-1d53-6baf-844f-266f0cc3d479\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"4fdf9331-f0c0-eec4-3719-85cd68e70ce8\"\n }\n }\n }\n },\n {\n \"amount\": 9528.415012008354,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"4f600188-f4cb-94c8-a32e-38ca56c16e7a\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"ee15356f-e2e2-1c93-e49c-70bfebb81103\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "Exceeded custom discount limit", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "74889f59-c63c-494f-b492-172694009536", "name": "Bulk Delete Custom Discounts From Cart", "request": { "name": "Bulk Delete Custom Discounts From Cart", "description": { "content": "Use this endpoint to bulk delete custom discounts from cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "9a549426-ceb1-4dc3-a96b-a1fcd8cde375", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4778564e-56de-4a3c-bc96-22abb6d75c83", "name": "Update Custom Discount For Cart", "request": { "name": "Update Custom Discount For Cart", "description": { "content": "Use this endpoint to update a custom discount in your cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "customdiscountID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be updated.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": {\n \"amount\": 9258.43818714027,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ad39f4bc-30d9-28a8-f65a-5b3ca08c2cbc\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8a760adb-9d48-4e16-98aa-7d868f65aee9", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be updated.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customdiscountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": {\n \"amount\": 9258.43818714027,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ad39f4bc-30d9-28a8-f65a-5b3ca08c2cbc\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"amount\": 5799.2043119021755,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"f1b1aae3-04ce-8a2c-1307-134cc13b35c5\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"dc9575fc-26cf-cd7b-0ff3-020c1e4dfdba\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aed4827f-5f01-4d41-ae80-b22af3619efe", "name": "Delete Custom Discount From Cart", "request": { "name": "Delete Custom Discount From Cart", "description": { "content": "Use this endpoint to delete custom discount from cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "customdiscountID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be deleted.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "3e02e6db-30e4-4fb7-a7fc-3680f8c05ad9", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be deleted.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customdiscountID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cf510b66-200a-4297-8a22-f963fea532fc", "name": "Add Custom Discount To Cart Item", "request": { "name": "Add Custom Discount To Cart Item", "description": { "content": "Use this endpoint to add a custom discount to cart item.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) Specifies the unique identifier for the cart item.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 2911.3901624082782,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"664d1f8a-75db-0a7c-0a21-a7bf4c5bb720\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7f05dc65-cf55-ab92-ddd6-4ca7f59b0870\",\n \"type\": \"custom_item\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "495757ca-fa72-4258-a6b4-d85b8e0a9f33", "name": "Successful request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier for the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 2911.3901624082782,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"664d1f8a-75db-0a7c-0a21-a7bf4c5bb720\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7f05dc65-cf55-ab92-ddd6-4ca7f59b0870\",\n \"type\": \"custom_item\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"amount\": 7861.341514248033,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"a4dc2ed4-c715-fd71-66e4-ca9ee3930bb3\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ebf5d2a4-67f8-bd7b-2d49-52b39a45ae8c\",\n \"type\": \"custom_item\"\n }\n }\n }\n },\n {\n \"amount\": 9460.858501425939,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"9de1ac67-ea62-46ae-197d-93e9021b1330\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"1cebd8e5-de9a-0c99-e6aa-56137c7b593c\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "488e3bca-c271-4bd2-8e1a-23598c2907b2", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier for the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 2911.3901624082782,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"664d1f8a-75db-0a7c-0a21-a7bf4c5bb720\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7f05dc65-cf55-ab92-ddd6-4ca7f59b0870\",\n \"type\": \"custom_item\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Custom discounts not enabled for this cart\",\n \"status\": 400,\n \"title\": \"Bad Request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "addce0ec-af0c-4d56-a5b0-4a37cb08f6da", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier for the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amount\": 2911.3901624082782,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"664d1f8a-75db-0a7c-0a21-a7bf4c5bb720\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"7f05dc65-cf55-ab92-ddd6-4ca7f59b0870\",\n \"type\": \"custom_item\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Custom discount limit reached for this cart item\",\n \"status\": 422,\n \"title\": \"Limit Reached\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b8ca6f75-4742-46a9-9d0d-7f9358127dd0", "name": "Update Custom Discount For Cart Item", "request": { "name": "Update Custom Discount For Cart Item", "description": { "content": "Use this endpoint to update a custom discount in your cart item.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "customdiscountID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be updated.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": {\n \"amount\": 9258.43818714027,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ad39f4bc-30d9-28a8-f65a-5b3ca08c2cbc\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "28daf0e7-7cae-4a99-929e-05eb27f709ee", "name": "200", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be updated.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customdiscountID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"amount\": {\n \"amount\": 9258.43818714027,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"ad39f4bc-30d9-28a8-f65a-5b3ca08c2cbc\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"amount\": 5799.2043119021755,\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"discount_engine\": \"string\",\n \"external_id\": \"string\",\n \"type\": \"string\",\n \"id\": \"f1b1aae3-04ce-8a2c-1307-134cc13b35c5\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"dc9575fc-26cf-cd7b-0ff3-020c1e4dfdba\",\n \"type\": \"cart_item\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e7d20670-8d38-469f-94dc-32ea70f1533b", "name": "Delete Custom Discount From Cart Item", "request": { "name": "Delete Custom Discount From Cart Item", "description": { "content": "Use this endpoint to delete custom discount from cart item.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "customdiscountID", "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be deleted.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "aed479db-cb87-4b97-b70e-f2be4df82e00", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "custom-discounts", ":customdiscountID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) Specifies the ID for the custom discount to be deleted.", "type": "text/plain" }, "type": "any", "value": "string", "key": "customdiscountID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Cart Settings", "description": "Use Cart Settings to configure cart behavior for your store, including cart expiry, custom discounts, rule promotions, deferred inventory checks, and cart visibility for admins.\n", "item": [ { "id": "146e69e8-1fe3-451f-9d04-bd7874812d08", "name": "Get Cart Settings", "request": { "name": "Get Cart Settings", "description": { "content": "Retrieves cart settings.", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6cb00c07-6107-4ce7-ab32-2b3141090692", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"id\": \"15419118-44ce-5343-8ff6-574daf52bc6b\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f8deeb7-2d6f-4206-8b42-d86cc96034c4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "26aabb1f-8db9-4f79-ac8f-c72e16121876", "name": "Update Cart Settings", "request": { "name": "Update Cart Settings", "description": { "content": "You can modify the cart expiry settings to set it to any number of days up to 365. Any existing carts default to the expiry of 7 days. To update cart settings in Commerce Manager, see [Updating Cart setting](/docs/commerce-manager/settings/general-settings#updating-cart-settings).\n\nWith update cart settings endpoint, you can:\n\n- Enable or disable custom discounts by setting the `custom_discounts_enabled` field to `true`. This allows you to activate your custom discounts from external services. By default, this setting is determined by the cart settings configured for the store.\n- Enable or disable the use of rule promotions within the cart. You can apply this setting either at the store level using the update cart setting endpoint or individually to a specific cart using the [update a cart](/docs/api/carts/update-a-cart) endpoint.\n- Enable or disable deferred inventory checks by setting `defer_inventory_check` to `true`. When set, stock levels are not verified for products in a cart until checkout.\n- Control whether admins can see all carts or only shopper-associated carts by setting `show_all_carts` to `true` or `false`.\n- Enable or disable location-based item separation by setting `separate_items_by_location` to `true`. When enabled, cart items with the same SKU but different locations are kept as separate line items instead of being merged.\n\n:::note\n\nYou cannot use both custom discounts and rule promotions at the same time.\n\n:::\n\n### Errors\n\nThe following error is received if you enable a cart to use both custom discounts and rule promotions:\n\n```json\n{\n \"status\": 422,\n \"title\": \"Cannot use both discounts together\",\n \"detail\": \"Only one discount setting can be set to true at a time.\"\n}\n```", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c1d08800-1f57-4692-b4e0-a9be8fc07dce", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"id\": \"15419118-44ce-5343-8ff6-574daf52bc6b\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd32d00c-a71f-4009-aca9-23f7196097d4", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54e6876e-0690-4711-bb6c-adf9bace7d26", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bf1dc73-f464-499e-a31f-53a32b3cacee", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "settings", "cart" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e29f3f1-a56b-4e97-957b-7cc00c82d617", "name": "Get Cart Settings by Store ID", "request": { "name": "Get Cart Settings by Store ID", "description": { "content": "Retrieves cart settings for the specified store.", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "storeID", "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "34e83913-3054-43c3-821a-716b493bca75", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"id\": \"15419118-44ce-5343-8ff6-574daf52bc6b\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58f8c0b8-b6ee-4b4e-9fc7-c1a18ca07151", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b3716b91-7e42-4867-a034-fd92480064e5", "name": "Update Cart Settings by Store ID", "request": { "name": "Update Cart Settings by Store ID", "description": { "content": "You can modify the cart expiry settings to set it to any number of days up to 365. Any existing carts default to the expiry of 7 days. To update cart settings in Commerce Manager, see [Updating Cart setting](/docs/commerce-manager/settings/general-settings#updating-cart-settings).\n\nWith update cart settings endpoint, you can:\n\n- Enable or disable custom discounts by setting the `custom_discounts_enabled` field to `true`. This allows you to activate your custom discounts from external services. By default, this setting is determined by the cart settings configured for the store.\n- Enable or disable the use of rule promotions within the cart. You can apply this setting either at the store level using the update cart setting endpoint or individually to a specific cart using the [update a cart](/docs/api/carts/update-a-cart) endpoint.\n- Enable or disable deferred inventory checks by setting `defer_inventory_check` to `true`. When set, stock levels are not verified for products in a cart until checkout.\n- Control whether admins can see all carts or only shopper-associated carts by setting `show_all_carts` to `true` or `false`.\n- Enable or disable location-based item separation by setting `separate_items_by_location` to `true`. When enabled, cart items with the same SKU but different locations are kept as separate line items instead of being merged.\n\n:::note\n\nYou cannot use both custom discounts and rule promotions at the same time.\n\n:::\n\n### Errors\n\nThe following error is received if you enable a cart to use both custom discounts and rule promotions:\n\n```json\n{\n \"status\": 422,\n \"title\": \"Cannot use both discounts together\",\n \"detail\": \"Only one discount setting can be set to true at a time.\"\n}\n```", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "storeID", "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d3e88bac-8889-4c0b-932b-d4426f569db3", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"id\": \"15419118-44ce-5343-8ff6-574daf52bc6b\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "664233b0-c985-4539-9b12-abea586e193e", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dc27c03-9d17-4a93-96b4-e314d8cc7b1a", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48509eef-6ae4-4723-ba82-22ad716e5871", "name": "Forbidden", "originalRequest": { "url": { "path": [ "v2", "settings", "cart", ":storeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The store ID.", "type": "text/plain" }, "type": "any", "value": "string", "key": "storeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"settings\",\n \"cart_expiry_days\": 25,\n \"discounts\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": false\n },\n \"inventories\": {\n \"defer_inventory_check\": false\n },\n \"items\": {\n \"separate_items_by_location\": false\n },\n \"show_all_carts\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Tax Items", "description": "Taxes differ by country and can differ within the country by region, state, or province. Each jurisdiction has a unique tax code and rate. If your store serves many jurisdictions, integrate a third-party tax generator to manage taxes. If your store serves a few jurisdictions, you can use the API to define the tax codes and rates in Composable Commerce.\n\nTaxes are calculated after all promotional discounts have been applied. When calculating taxes on a cart or order, you can choose from the following methods for calculating taxes:\n\n - Simple calculation method: Taxes are calculated at the unit level and are rounded to the nearest penny for the unit.\n - Line calculation method: Default. Taxes are calculated at the line level and are rounded to the nearest penny for the line.\n For more information about calculation methods, see [Calculate cart and order totals](/guides/How-To/Carts/calculate-totals).\n\nTax values can be either `rate` or `amount`.\n - `rate` - Represents the tax as a percentage in decimal form.\n - `amount` - Represents a tax amount.\n\n:::note\nTax items can be added and removed using [client_credentials access tokens](/docs/api/authentication/create-an-access-token). Only administrators with `client-credentials` access tokens are able to manage tax items.\n:::\n", "item": [ { "id": "40498d1a-153f-44cd-b43b-1bd04da27c4a", "name": "Add Tax Item to Cart", "request": { "name": "Add Tax Item to Cart", "description": { "content": "\nUse this endpoint to add a tax item to a cart.\n\n:::note\n\nThere is a soft limit of 5 unique tax items per cart item at any one time.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b6678867-e0c9-42dd-a939-ddbc83c3a19a", "name": "Rate-based tax item", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"662461ad-ddcb-4dbd-8ed7-ade9aa63b5f9\",\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5e8b43b-0821-4b07-b90d-484876e7c76c", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"3f3b5e26-7e7e-4d2d-a3a7-5e9b1f72fabc\",\n \"type\": \"tax_item\",\n \"code\": \"GST\",\n \"jurisdiction\": \"AU\",\n \"name\": \"Goods and Services Tax\",\n \"amount\": 1000\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05e860df-2185-43e8-b2f0-f5a012a8447e", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1d112f8d-4c39-4131-8a48-506cf269952c", "name": "Add Tax Item to Bundle Component", "request": { "name": "Add Tax Item to Bundle Component", "description": { "content": "\nUse this endpoint to add a tax item to a specific bundle component (component product) within a cart item.\n\n:::note\n\nThere is a soft limit of 5 unique tax items per component product at any one time.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "productID", "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "bcf90747-4ad8-4745-ba71-5043f07fb862", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4f4e6d37-8c8c-4a1a-b8a3-6cd2efab12de\",\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f9b3897-9596-4be9-bd66-706766230843", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a87cdd7e-9a88-4f16-9a0a-38f68b3a6737", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe914913-ad8d-42db-a48d-59cae8a4fc4a", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "190393a4-b093-4faa-ad97-bd3ba84de48f", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.2\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c4bb57f5-28a4-45ec-a679-86223a4ef498", "name": "Update Tax Item on Bundle Component", "request": { "name": "Update Tax Item on Bundle Component", "description": { "content": "Use this endpoint to update a tax item on a specific bundle component (component product) within a cart item. To change tax value from `rate` to `amount`, set `rate` to `null`, then set `amount` value and vice versa.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "productID", "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "taxitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.18\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ff24c0c2-5908-4100-917b-c1f5e949a353", "name": "Updated bundle component tax item (amount)", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.18\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"7aa2ddad-2c5b-4d9b-9ce9-3e8cff778a10\",\n \"type\": \"tax_item\",\n \"code\": \"GST\",\n \"jurisdiction\": \"AU\",\n \"name\": \"Goods and Services Tax\",\n \"amount\": 1200\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b19f36e6-fe98-48d3-9c5d-f57947aa4931", "name": "Delete Tax Item from Bundle Component", "request": { "name": "Delete Tax Item from Bundle Component", "description": { "content": "\nUse this endpoint to delete a tax item from a specific bundle component (component product) within a cart item.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "productID", "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "taxitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "ae2fddc3-7948-4c20-997a-d4974d37045a", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "66c95f3f-92fb-4dd0-891f-65a6b8bf826f", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ac0d7a8-1899-42c7-bf9b-1713ed810bfe", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "components", ":productID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the component product within the bundle.", "type": "text/plain" }, "type": "any", "value": "string", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item on the component product.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "40cbcd38-21ad-427a-b377-8f4723ce971d", "name": "Bulk Add Tax Items to Cart", "request": { "name": "Bulk Add Tax Items to Cart", "description": { "content": "Use this endpoint to bulk add tax items to cart items and bundle component products.\n\n:::note\n\nA cart item can only have a maximum of five tax items.\nA bundle component product can only have a maximum of five tax items.\n\n:::\n\n### Bundle Component Taxes\n\nTo add tax items to bundle component products, include a `meta` object with `component_product_id` in each tax item:\n\n```json\n{\n \"data\": [\n {\n \"type\": \"tax_item\",\n \"code\": \"GST\",\n \"name\": \"Goods and Services Tax\",\n \"rate\": 0.1,\n \"meta\": {\n \"component_product_id\": \"12345678-1234-5678-9012-123456789012\"\n },\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"cart-item-id\"\n }\n }\n }\n }\n ]\n}\n```\n\n### Errors\n\n\n`422 Unprocessable Entity`\n\n\nIn this example, when `options.add_all_or_nothing` is set to `true` and if\none of cart items is not found or has reached its maximum tax item limit,\nthe following error response is returned:\n\n\n```json\n\n{\n \"status\": 422,\n \"title\": \"Add all or nothing.\",\n \"detail\": \"Add all or nothing set to (true). Could not bulk add tax items to cart.\"\n }\n\n```\n\n\nIn this example, if you add more than five tax items to the same cart item,\nthe following error response is returned:\n\n\n```json\n\n{\n \"status\": 422,\n \"title\": \"Tax item not added to cart item.\",\n \"detail\": \"Cannot exceed tax item limit of (5) on cart item.\",\n \"meta\": {\n \"id\": \"f88e6370-cb35-40b2-a998-c759f31dec0a\"\n }\n }\n```\n\n\n`404`\n\n\nIn this example, if there is a mismatch between `cart_item`/`custom_item`\nand the `relationships.item.data.type` specified in the bulk add tax item,\nthe following error response is returned:\n\n\n```json\n\n{\n \"data\": [],\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Tax item not added to cart item.\",\n \"detail\": \"Mismatch between bulk tax item type(cart_item) and cart item type(custom_item).\",\n \"meta\": {\n \"id\": \"56aab5d1-1dd4-45ed-88ed-4d0cc396b62d\"\n }\n },\n {\n \"status\": 404,\n \"title\": \"Tax item not added to cart item.\",\n \"detail\": \"Mismatch between bulk tax item type(cart_item) and cart item type(custom_item).\",\n \"meta\": {\n \"id\": \"56aab5d1-1dd4-45ed-88ed-4d0cc396b62d\"\n }\n }\n ]\n}\n\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"name\": \"Value Added Tax\",\n \"jurisdiction\": \"UK\",\n \"rate\": 0.2,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"5601a4b1-9d13-42d3-8fb7-03b35169d1b6\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fdcebcd9-053e-4365-81f0-96fad0637ab2", "name": "Bulk add response with generated IDs (rate)", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"name\": \"Value Added Tax\",\n \"jurisdiction\": \"UK\",\n \"rate\": 0.2,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"5601a4b1-9d13-42d3-8fb7-03b35169d1b6\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"98c2b4de-7f33-4b3a-8f2e-8c1b2a3d4e5f\",\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"name\": \"Value Added Tax\",\n \"jurisdiction\": \"UK\",\n \"rate\": 0.2,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"5601a4b1-9d13-42d3-8fb7-03b35169d1b6\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ebd6828-98a7-4311-ba34-c730eb87c919", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"name\": \"Value Added Tax\",\n \"jurisdiction\": \"UK\",\n \"rate\": 0.2,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"5601a4b1-9d13-42d3-8fb7-03b35169d1b6\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"2b3c4d5e-6f70-4a8b-9c0d-1e2f3a4b5c6d\",\n \"type\": \"tax_item\",\n \"code\": \"GST\",\n \"name\": \"Goods and Services Tax\",\n \"jurisdiction\": \"AU\",\n \"amount\": 1000,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"1a2b3c4d-5e6f-7a8b-9c0d-abcdefabcdef\"\n }\n }\n }\n },\n {\n \"id\": \"5e4d3c2b-1a0f-4b8a-9c0d-7f6e5d4c3b2a\",\n \"type\": \"tax_item\",\n \"code\": \"PST\",\n \"name\": \"Provincial Sales Tax\",\n \"jurisdiction\": \"CA-BC\",\n \"amount\": 250,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"custom_item\",\n \"id\": \"9f8e7d6c-5b4a-3210-fedc-ba9876543210\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a1dd98f-eb3b-4832-a9ca-86d9c8552d3b", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"name\": \"Value Added Tax\",\n \"jurisdiction\": \"UK\",\n \"rate\": 0.2,\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"type\": \"cart_item\",\n \"id\": \"5601a4b1-9d13-42d3-8fb7-03b35169d1b6\"\n }\n }\n }\n }\n ],\n \"options\": {\n \"add_all_or_nothing\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "47e669e0-5a9f-4817-9198-473052e64d0d", "name": "Bulk Delete Tax Items from Cart", "request": { "name": "Bulk Delete Tax Items from Cart", "description": { "content": "Use this endpoint to bulk delete all tax items from all cart items and bundle component products in the cart.\n\n:::warning\n\nThis operation will remove ALL tax items from:\n- All cart items in the cart\n- All bundle component products within bundle cart items\n\n:::\n\n### Behavior\n\n- Removes all tax items from every cart item\n- Removes all tax items from every component product in bundle cart items\n- If no tax items exist anywhere in the cart, returns a 404 error\n\n### Errors\n\n`404 Not Found`\n\nIf no tax items exist in the cart (on cart items or component products):\n\n```json\n{\n \"status\": 404,\n \"title\": \"Resource Not Found\",\n \"detail\": \"No tax items exist in the cart\"\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "85952744-9b33-43ba-87bc-e6f031a86f62", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f23ef5fb-3fd7-41ec-a82f-a5f4cfab91bc", "name": "Not Found - No tax items exist in the cart", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "taxes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "189b723a-ab79-427d-8fb7-d054c01563f3", "name": "Update a Tax Item", "request": { "name": "Update a Tax Item", "description": { "content": "Use this endpoint to update a tax item. To change tax value from `rate` to `amount`, set `rate` to `null`, then set `amount` value and vice versa.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "taxitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.15\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f71d122f-3cbd-494c-accf-8100f878efc3", "name": "Updated tax item (rate)", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.15\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"662461ad-ddcb-4dbd-8ed7-ade9aa63b5f9\",\n \"type\": \"tax_item\",\n \"code\": \"VAT\",\n \"jurisdiction\": \"UK\",\n \"name\": \"Value Added Tax\",\n \"rate\": 0.15\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "15752b93-63d3-4f83-9b39-6474528217fc", "name": "Delete a Tax Item", "request": { "name": "Delete a Tax Item", "description": { "content": "Use this endpoint to delete a tax item.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "cartitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "taxitemID", "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "3ecfe35b-9323-4e36-9758-acdcf7fe7ae0", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "items", ":cartitemID", "taxes", ":taxitemID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartitemID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the tax item.", "type": "text/plain" }, "type": "any", "value": "string", "key": "taxitemID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Cart Shipping Groups", "description": "", "item": [ { "id": "371fb29b-7c45-4ea0-aa6a-4e9854319acb", "name": "Retrieve all shipping groups for a cart", "request": { "name": "Retrieve all shipping groups for a cart", "description": { "content": "Retrieve all shipping groups for a cart", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "12b36b91-08e7-4556-8e67-b0ce7dbd2fa2", "name": "A list of shipping groups", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"type\": \"shipping_group\",\n \"relation\": \"cart\",\n \"cart_id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"shipping_type\": \"standard\",\n \"tracking_reference\": \"TRACK123\",\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1000,\n \"currency\": \"USD\",\n \"formatted\": \"$10.00\"\n },\n \"base\": {\n \"amount\": 800,\n \"currency\": \"USD\",\n \"formatted\": \"$8.00\"\n },\n \"tax\": {\n \"amount\": 200,\n \"currency\": \"USD\",\n \"formatted\": \"$2.00\"\n },\n \"fees\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n }\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n },\n \"delivery_estimate\": {\n \"start\": \"2024-01-15T00:00:00Z\",\n \"end\": \"2024-01-20T00:00:00Z\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d13110b-0388-40e6-95d6-8c69d0b55e41", "name": "Cart not found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0d6327c0-ebfe-4cc8-b1af-204a0b0dc980", "name": "Create a new shipping group for a cart", "request": { "name": "Create a new shipping group for a cart", "description": { "content": "Create a new shipping group for a cart", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"shipping_price\": {\n \"total\": 8487.185792128192,\n \"base\": 6823.665675288173,\n \"tax\": 6551.072375505695,\n \"fees\": 1848.7203558617748,\n \"discount\": 4777.098458967097\n },\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"includes_tax\": false,\n \"delivery_estimate\": {\n \"start\": \"1978-11-27T00:57:51.694Z\",\n \"end\": \"2000-04-26T14:48:27.090Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0d5d83ed-2dd9-4f78-9a70-1c672686f1bf", "name": "Shipping group created successfully", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"shipping_price\": {\n \"total\": 8487.185792128192,\n \"base\": 6823.665675288173,\n \"tax\": 6551.072375505695,\n \"fees\": 1848.7203558617748,\n \"discount\": 4777.098458967097\n },\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"includes_tax\": false,\n \"delivery_estimate\": {\n \"start\": \"1978-11-27T00:57:51.694Z\",\n \"end\": \"2000-04-26T14:48:27.090Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"type\": \"shipping_group\",\n \"relation\": \"cart\",\n \"cart_id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"shipping_type\": \"standard\",\n \"tracking_reference\": \"TRACK123\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n },\n \"delivery_estimate\": {\n \"start\": \"2024-01-15T00:00:00Z\",\n \"end\": \"2024-01-20T00:00:00Z\"\n },\n \"created_at\": \"2024-01-10T12:00:00Z\",\n \"updated_at\": \"2024-01-10T12:00:00Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a66cb408-9d8e-4125-b1dc-0698b35fb827", "name": "Invalid request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"shipping_price\": {\n \"total\": 8487.185792128192,\n \"base\": 6823.665675288173,\n \"tax\": 6551.072375505695,\n \"fees\": 1848.7203558617748,\n \"discount\": 4777.098458967097\n },\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"includes_tax\": false,\n \"delivery_estimate\": {\n \"start\": \"1978-11-27T00:57:51.694Z\",\n \"end\": \"2000-04-26T14:48:27.090Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Cart Currency Mismatch\",\n \"detail\": \"This cart uses USD, cannot add shipping group with currency EUR\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fe83a57-0141-4a37-bc8d-8b052ac387e5", "name": "Cart not found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"shipping_price\": {\n \"total\": 8487.185792128192,\n \"base\": 6823.665675288173,\n \"tax\": 6551.072375505695,\n \"fees\": 1848.7203558617748,\n \"discount\": 4777.098458967097\n },\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"includes_tax\": false,\n \"delivery_estimate\": {\n \"start\": \"1978-11-27T00:57:51.694Z\",\n \"end\": \"2000-04-26T14:48:27.090Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"Cart not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fe950a31-9289-4841-be4f-9cdd974a340e", "name": "Retrieve a specific shipping group for a cart", "request": { "name": "Retrieve a specific shipping group for a cart", "description": { "content": "Retrieve a specific shipping group for a cart", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartId", "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "shippingGroupId", "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3355b6bd-281f-4d67-9275-47f18d2f117f", "name": "Shipping group details", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"7cfa5b07-092e-4dbe-bbad-55a771a34117\",\n \"type\": \"shipping_group\",\n \"relation\": \"cart\",\n \"cart_id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"shipping_type\": \"standard\",\n \"tracking_reference\": \"TRACK123\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n },\n \"delivery_estimate\": {\n \"start\": \"2024-01-15T00:00:00Z\",\n \"end\": \"2024-01-20T00:00:00Z\"\n },\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1000,\n \"currency\": \"USD\",\n \"formatted\": \"$10.00\"\n },\n \"base\": {\n \"amount\": 800,\n \"currency\": \"USD\",\n \"formatted\": \"$8.00\"\n },\n \"tax\": {\n \"amount\": 200,\n \"currency\": \"USD\",\n \"formatted\": \"$2.00\"\n },\n \"fees\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bf37449-7bc3-4cee-b057-8bf0dfcaf9ce", "name": "Shipping group or cart not found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"Cart not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f7010c8b-8e89-4f2d-8aae-51d2a394ab40", "name": "Update a shipping group for a cart", "request": { "name": "Update a shipping group for a cart", "description": { "content": "Update a specific shipping group for a cart", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartId", "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "shippingGroupId", "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"shipping_price\": {\n \"base\": 1500,\n \"tax\": 300,\n \"fees\": 200\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f4096662-b202-430a-a6b4-158e58ae0dce", "name": "Shipping group updated successfully", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"shipping_price\": {\n \"base\": 1500,\n \"tax\": 300,\n \"fees\": 200\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"relation\": \"string\",\n \"cart_id\": \"string\",\n \"order_id\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"2022-01-13T05:25:39.165Z\",\n \"end\": \"1980-11-02T21:34:30.962Z\"\n },\n \"created_at\": \"2004-12-02T00:00:04.985Z\",\n \"updated_at\": \"1996-04-19T22:39:35.871Z\",\n \"relationships\": {\n \"cart\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"1443f6ff-7cc3-6a19-15d4-43fb0f603c03\"\n }\n },\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"8c2c29c1-d8e3-7de5-5c47-b246870f5e76\"\n }\n }\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 3631,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9071\n },\n {\n \"amount\": {\n \"amount\": 1898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 2066\n }\n ],\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1792.9542924748644,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"base\": {\n \"amount\": 4126.934486687388,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9901.496323221992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"fees\": {\n \"amount\": 3391.3139788178405,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 585.0035496930839,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"total_display_price\": {\n \"with_tax\": {\n \"amount\": 2925.4614944046975,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 9460.695289653186,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3289.481762307327,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 4631.269695537788,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 4881.939933445616,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 7227.279746213222,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 9764.781431787844,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 5467.963108835874,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"included\": {\n \"items\": [\n {\n \"type\": \"string\",\n \"id\": \"cdcb3506-4a12-a0f4-0afa-f7cb3abc488d\",\n \"quantity\": 1650.4510621227996,\n \"product_id\": \"43d945dc-32ed-fa43-fd7d-b41d69ea23c5\",\n \"subscription_offering_id\": \"b03fd3da-5bed-c535-2168-bde340cee50f\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 9600.881253646385,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 2324.6575024221806,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 7264.717169576469,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"da738fe0-f6d7-d06b-2fde-b6ac8388ffe0\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 41\n },\n {\n \"amount\": {\n \"amount\": 2304.7894811326187,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"6853c7cf-811b-5982-da7c-2ff71a2cab97\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 4865\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 7524.851639665872,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6927.666267744797,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 1937.2718471294825,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7072.917874628788,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5373.499261614858,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4189.288208605974,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 597.5745658249255,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6657.445399555455,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 448.5472470252927,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7935.256618551001,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 7469.593486437287,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 2943.5117444957727,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 801.048290586368,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 1912.8473280678038,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 2024.4305787316796,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 2447.5625199781416,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 3249.6320121131107,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_3\": {\n \"amount\": 478.6132436967838,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 1319.9727274620686,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 3235.7479073928143,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 5479.299348562643,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_3\": {\n \"amount\": 9952.034275655758,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 4804.124098663938,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 4765.437599505544,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 7335.714949622514,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5352.41890629004,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"ce33e58a-0957-6bde-2f74-2cde0089fe98\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 4099.960895010812\n },\n \"key_1\": {\n \"key_0\": 629.2818251224563\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 6669\n },\n \"price\": {\n \"key_0\": false\n },\n \"relationships\": {\n \"key_0\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 3848.717986001613,\n \"key_1\": 6025.9759917461815\n },\n \"meta\": {\n \"key_0\": 4332.987839337532\n },\n \"price\": {\n \"key_0\": 2220.2678867161253,\n \"key_1\": 577,\n \"key_2\": 90.97801613287437\n },\n \"relationships\": {\n \"key_0\": 6916\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 8377.66403689102,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 3226.4776876521896,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 5574.578779119923,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 3208.4480153369,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 5537,\n \"key_1\": 8828.461590739864\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 6517.525037582553\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"aef7d331-9de0-2f2c-75da-4f5ec2dbdfcc\",\n \"quantity\": 5152.002115742551,\n \"product_id\": \"646ddb77-fee5-cad9-7c30-8eb6cd09a519\",\n \"subscription_offering_id\": \"3dd7adc2-c89a-183a-1345-79eec16ec068\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 5191.789530070659,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 7787.14660221987,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 6863.059114494943,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"6fb659ee-3dfe-5a6a-4e72-652bcbcb2a20\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 8912\n },\n {\n \"amount\": {\n \"amount\": 9203.247633844318,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"520fb74a-cbdc-96b3-fc8b-b3d6d8e47cef\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 3981\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 9760.93180761923,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7559.732911203003,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8227.454329670909,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6548.160520022412,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 8377.0683837577,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4558.4470540144275,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 9221.338849212894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4852.161542973366,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 1625.3959787738913,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 441.33850605853286,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 2671.790342353706,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 8798.223724182388,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 1828.3243224284206,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7833.581081204823,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 3103.018801133146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 4350.9895386353455,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 4932.697937166015,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 148.2011595330812,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 9928.35827321542,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4802.731894070669,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"6c4779bd-94e6-5d81-d5f0-51425c81848d\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 1264.2272520563113,\n \"key_1\": 4968.772945774968,\n \"key_2\": 9895.815120415564,\n \"key_3\": 7163.460507084867\n },\n \"key_1\": {\n \"key_0\": 4705.0844333535215,\n \"key_1\": 5097.618334999359,\n \"key_2\": 7149.124948766499\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 5950,\n \"key_1\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": false,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": true\n },\n \"relationships\": {\n \"key_0\": 1151.3187412639625,\n \"key_1\": 8121.503261524792\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 9356,\n \"key_1\": 3247.7402547322854\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"price\": {\n \"key_0\": false\n },\n \"relationships\": {\n \"key_0\": false,\n \"key_1\": false\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3216.892720275415,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 1040.0687107239714,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 8772,\n \"key_1\": 605.2546493368683,\n \"key_2\": 2827.1506670060953\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": false\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": 7576.340661630256\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 5096,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"3lOcSAfH@jrhMRUvAngGbNkAHLBEgACUXdsO.qsss\",\n \"component_product_id\": \"fb0e122a-fcf1-61a2-db2c-c8208fdb185a\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 6065,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"shavty@eUNtfDcZjTegzErdWpAzYFPhtCDb.qoqk\",\n \"component_product_id\": \"7a43893b-a6c9-f4a5-4dac-ded7a2a1bfcf\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "604f6a18-c337-4ec0-b789-731b87abee2e", "name": "Invalid request", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"shipping_price\": {\n \"base\": 1500,\n \"tax\": 300,\n \"fees\": 200\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Cart Currency Mismatch\",\n \"detail\": \"The existing shipping group uses USD, cannot update shipping group with currency EUR\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e7a9624-7b42-4724-9b67-7b4a59227584", "name": "Shipping group or cart not found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"shipping_price\": {\n \"base\": 1500,\n \"tax\": 300,\n \"fees\": 200\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Cart shipping group not found\",\n \"detail\": \"Cart shipping group with ID [7cfa5b07-092e-4dbe-bbad-55a771a34117] not found for cart [abc123]\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2eb4fbef-16a4-4dcb-bc5f-ab71e15fa398", "name": "Delete Cart Shipping Group", "request": { "name": "Delete Cart Shipping Group", "description": { "content": "Deletes a shipping group from a cart. You cannot delete a shipping group that is attached to cart items.\nYou must first remove the shipping group from all cart items before deleting the shipping group.\n", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartId", "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "shippingGroupId", "disabled": false, "description": { "content": "(Required) The ID of the shipping group to delete", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "749e763c-d5bc-4ad3-9728-c6ed70cb2e1d", "name": "Successfully deleted the shipping group", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group to delete", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e5a47384-d742-4e80-aa00-7a8f9afae4dd", "name": "Cannot delete shipping group that is attached to cart items", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group to delete", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Cannot delete shipping group\",\n \"detail\": \"Cannot delete shipping groups attached to cart items. Please remove the shipping group from its cart items and try again.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6d3c97f-e594-4cbf-af63-d864ed4520cf", "name": "Cart or shipping group not found", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartId", "shipping-groups", ":shippingGroupId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the cart", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartId" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group to delete", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"YnNB1FRx@mqBtqtFBJebtdmIypOF.ayge\",\n \"component_product_id\": \"2848f923-2920-f7c2-8604-df0a2a6e28e9\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"rsY3BGtx@VmqyICLOzLEqs.zb\",\n \"component_product_id\": \"f0976a25-e370-fe5f-698d-ef822985c529\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Cart Payments", "description": "", "item": [ { "id": "eff042ca-6d12-402f-9508-ef495a32706b", "name": "Update a Payment Intent on a Cart", "request": { "name": "Update a Payment Intent on a Cart", "description": { "content": "Updates the payment information for a specific payment intent on a cart.", "type": "text/plain" }, "url": { "path": [ "v2", "carts", ":cartID", "payments", ":paymentIntentID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "cartID", "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "paymentIntentID", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment intent.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"string\",\n \"method\": \"string\",\n \"payment_method_types\": [\n \"string\",\n \"string\"\n ],\n \"amount\": 4026,\n \"options\": {}\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9fc70575-26d9-418d-b92b-0e0f0faef4e7", "name": "Payment updated successfully", "originalRequest": { "url": { "path": [ "v2", "carts", ":cartID", "payments", ":paymentIntentID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the cart.", "type": "text/plain" }, "type": "any", "value": "string", "key": "cartID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment intent.", "type": "text/plain" }, "type": "any", "value": "string", "key": "paymentIntentID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"gateway\": \"string\",\n \"method\": \"string\",\n \"payment_method_types\": [\n \"string\",\n \"string\"\n ],\n \"amount\": 4026,\n \"options\": {}\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"contact\": {\n \"email\": \"BYW@fvtPQHikMlhvFheliuFLuqyQXLFPeXcB.mt\"\n },\n \"discount_settings\": {\n \"custom_discounts_enabled\": false,\n \"use_rule_promotions\": true\n },\n \"inventory_settings\": {\n \"defer_inventory_check\": false\n },\n \"item_settings\": {\n \"separate_items_by_location\": false\n },\n \"payment_intent_id\": \"string\",\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"integer\",\n \"value\": \"string\"\n },\n \"key_1\": {\n \"type\": \"boolean\",\n \"value\": 822.6772421098926\n },\n \"key_2\": {\n \"type\": \"integer\",\n \"value\": 126.79575312376734\n }\n },\n \"snapshot_date\": \"1984-05-06T14:31:35.698Z\",\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"amount\": 7724.690250418494,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 965.6893846416992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9240.72236121114,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 188.6342658542728,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 4122.139928207081,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8153.970412608016,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 8167.249846653129,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\",\n \"expires_at\": \"string\"\n },\n \"promotion_suggestions\": [\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 2122,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": 1393.0676428419474,\n \"key_1\": 5865,\n \"key_2\": false\n },\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 2964,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 6458,\n \"key_3\": 9043.797956152996\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n },\n {\n \"bundle\": [\n {\n \"auto_add_free_gift\": true,\n \"cart_item_id\": \"string\",\n \"quantity\": 4626,\n \"targets\": [\n \"string\",\n \"string\"\n ],\n \"key_0\": \"string\"\n },\n {\n \"auto_add_free_gift\": false,\n \"cart_item_id\": \"string\",\n \"quantity\": 955,\n \"targets\": [\n \"string\",\n \"string\"\n ]\n }\n ],\n \"code\": \"string\",\n \"info\": \"string\",\n \"message\": \"string\",\n \"promotion_id\": \"string\"\n }\n ]\n },\n \"relationships\": {\n \"customers\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"57c7ca77-1c04-de46-8283-92537a5691fb\"\n },\n {\n \"type\": \"string\",\n \"id\": \"03cbbace-aba2-d8fe-25b8-0cb4e786d75a\"\n }\n ]\n },\n \"items\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"cb813261-ffc1-6204-012e-55cc805858fe\"\n },\n {\n \"type\": \"string\",\n \"id\": \"07a16b25-827c-ba50-0486-c7de1457ae77\"\n }\n ]\n },\n \"accounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7e8a5c67-b7b2-6d1d-81ab-d4af345edff0\"\n },\n {\n \"type\": \"string\",\n \"id\": \"54f4444f-9f2b-c23d-cb0d-037e11213487\"\n }\n ]\n },\n \"custom_discounts\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"2bb549af-f621-257f-f762-46f4d8d8286b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"6b5cfc90-a884-4bf5-eee9-7ff40bb0efcc\"\n }\n ]\n },\n \"promotions\": {\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"3254f8bd-e55f-3d7e-a366-007cbd64bc6b\"\n },\n {\n \"type\": \"string\",\n \"id\": \"e1272995-876e-86b5-5724-9856596ffdee\"\n }\n ]\n }\n },\n \"type\": \"string\"\n },\n \"included\": {\n \"custom_discounts\": [\n {\n \"type\": \"string\",\n \"id\": \"6f41b966-482a-3900-d8ec-2fdcef590adf\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 6175.651459105089,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"599189db-6f15-3977-ec51-8fb379d98eff\",\n \"type\": \"cart_item\"\n }\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"0d0ac6bf-1a9e-6244-5021-e01c8de37428\",\n \"external_id\": \"string\",\n \"discount_engine\": \"string\",\n \"amount\": {\n \"amount\": 703.8131625745225,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"description\": \"string\",\n \"discount_code\": \"string\",\n \"relationships\": {\n \"item\": {\n \"data\": {\n \"id\": \"8713c39d-7f57-534b-8451-6d15fff0667e\",\n \"type\": \"custom_item\"\n }\n }\n }\n }\n ],\n \"promotions\": [\n {\n \"type\": \"string\",\n \"id\": \"7d28230f-b33c-99b1-0427-67677ee6f2e6\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"1977-10-28T16:57:46.835Z\",\n \"end\": \"1994-11-29T00:54:35.861Z\"\n },\n {\n \"type\": \"string\",\n \"id\": \"a54245b5-921a-05b3-ea7d-c6a36c072882\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"promotion_type\": \"string\",\n \"promotion_source\": \"string\",\n \"start\": \"2005-03-24T22:56:18.880Z\",\n \"end\": \"1976-08-30T19:13:41.495Z\"\n }\n ]\n },\n \"meta\": {\n \"payment_intent\": {\n \"key_0\": \"string\"\n }\n },\n \"errors\": [\n {\n \"status\": \"string\",\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"9jC5C@kYJCTLLKKXzXfEvkHoyh.ytaf\",\n \"component_product_id\": \"4f414aa9-0189-8467-15f8-839642991de7\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 7590,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"hcA@vcvu.dulp\",\n \"component_product_id\": \"5f7524f1-86a7-57ab-1ae4-c6483195beea\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Order Shipping Groups", "description": "", "item": [ { "id": "d1872d6d-074a-4376-a35b-68bee188bd52", "name": "Retrieve all shipping groups for an order", "request": { "name": "Retrieve all shipping groups for an order", "description": { "content": "Retrieve all shipping groups for an order", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fd6e29e3-9ece-4993-96b7-9fc944571e7a", "name": "A list of shipping groups", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"type\": \"shipping_group\",\n \"relation\": \"order\",\n \"order_id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"shipping_type\": \"standard\",\n \"tracking_reference\": \"TRACK123\",\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1000,\n \"currency\": \"USD\",\n \"formatted\": \"$10.00\"\n },\n \"base\": {\n \"amount\": 800,\n \"currency\": \"USD\",\n \"formatted\": \"$8.00\"\n },\n \"tax\": {\n \"amount\": 200,\n \"currency\": \"USD\",\n \"formatted\": \"$2.00\"\n },\n \"fees\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n }\n },\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n },\n \"delivery_estimate\": {\n \"start\": \"2024-01-15T00:00:00Z\",\n \"end\": \"2024-01-20T00:00:00Z\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2802529-ce12-4b6d-9ca8-2885ef20389c", "name": "Order not found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"Order not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4ec11f74-077a-49a9-915e-08fdaf2a49ce", "name": "Create a shipping group for an order", "request": { "name": "Create a shipping group for an order", "description": { "content": "Create a new shipping group for an order", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"address\": {\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"phone_number\": \"string\",\n \"company_name\": \"string\",\n \"line_1\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"postcode\": \"string\",\n \"county\": \"string\",\n \"country\": \"string\",\n \"region\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1992-02-18T12:36:11.856Z\",\n \"end\": \"1977-11-28T05:45:19.359Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2cf7c4a0-99dc-4bd6-80f0-17361fcf1c7d", "name": "Shipping group created", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"address\": {\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"phone_number\": \"string\",\n \"company_name\": \"string\",\n \"line_1\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"postcode\": \"string\",\n \"county\": \"string\",\n \"country\": \"string\",\n \"region\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1992-02-18T12:36:11.856Z\",\n \"end\": \"1977-11-28T05:45:19.359Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"relation\": \"string\",\n \"cart_id\": \"string\",\n \"order_id\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1977-03-27T21:21:51.678Z\",\n \"end\": \"2022-01-30T07:38:18.949Z\"\n },\n \"created_at\": \"2020-08-01T04:29:28.289Z\",\n \"updated_at\": \"1957-10-10T08:58:11.198Z\",\n \"relationships\": {\n \"cart\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"067ea6c0-82d2-37c7-3b62-bfce5e845a69\"\n }\n },\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"6f7d78db-f5b3-9cb6-9943-30887ce49d31\"\n }\n }\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 6970,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 905\n },\n {\n \"amount\": {\n \"amount\": 4687,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 3047\n }\n ],\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 5367.183416318056,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"base\": {\n \"amount\": 9964.70176037528,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3902.6415817471216,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"fees\": {\n \"amount\": 2577.7730353892903,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 2957.701309889875,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"total_display_price\": {\n \"with_tax\": {\n \"amount\": 4279.245256212854,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 1834.0009389542854,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 2512.5359674331426,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 6031.50892801795,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 9529.188946367525,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 5377.010356545861,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 1494.2467446864516,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 8360.666260896869,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc1d35f5-fe4e-46a5-aa70-4156be7f3057", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"address\": {\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"phone_number\": \"string\",\n \"company_name\": \"string\",\n \"line_1\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"postcode\": \"string\",\n \"county\": \"string\",\n \"country\": \"string\",\n \"region\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1992-02-18T12:36:11.856Z\",\n \"end\": \"1977-11-28T05:45:19.359Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"Invalid request format\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c61a206-a0bd-46cd-8e3b-668696b0d1eb", "name": "Order not found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"address\": {\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"phone_number\": \"string\",\n \"company_name\": \"string\",\n \"line_1\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"postcode\": \"string\",\n \"county\": \"string\",\n \"country\": \"string\",\n \"region\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1992-02-18T12:36:11.856Z\",\n \"end\": \"1977-11-28T05:45:19.359Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"Order not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d10907e5-6f39-4e41-9657-ba6c2ce8fe30", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"address\": {\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"phone_number\": \"string\",\n \"company_name\": \"string\",\n \"line_1\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"postcode\": \"string\",\n \"county\": \"string\",\n \"country\": \"string\",\n \"region\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"1992-02-18T12:36:11.856Z\",\n \"end\": \"1977-11-28T05:45:19.359Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 422,\n \"title\": \"Unprocessable Entity\",\n \"detail\": \"Cannot create shipping group for this order\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "649c3d10-e2f2-453f-909c-567ec1cda36c", "name": "Retrieve a specific shipping group for an order", "request": { "name": "Retrieve a specific shipping group for an order", "description": { "content": "Retrieve a specific shipping group for an order", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "A comma-separated list of related resources to include in the response.", "type": "text/plain" }, "key": "include", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "shippingGroupID", "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cbd7c722-5c27-41b2-9ffa-cc15104e9c14", "name": "Shipping group details", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "A comma-separated list of related resources to include in the response.", "type": "text/plain" }, "key": "include", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"7cfa5b07-092e-4dbe-bbad-55a771a34117\",\n \"type\": \"shipping_group\",\n \"relation\": \"order\",\n \"order_id\": \"96b1d104-0d2e-41fd-9543-6c3c5a698959\",\n \"shipping_type\": \"standard\",\n \"tracking_reference\": \"TRACK123\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n },\n \"delivery_estimate\": {\n \"start\": \"2024-01-15T00:00:00Z\",\n \"end\": \"2024-01-20T00:00:00Z\"\n },\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1000,\n \"currency\": \"USD\",\n \"formatted\": \"$10.00\"\n },\n \"base\": {\n \"amount\": 800,\n \"currency\": \"USD\",\n \"formatted\": \"$8.00\"\n },\n \"tax\": {\n \"amount\": 200,\n \"currency\": \"USD\",\n \"formatted\": \"$2.00\"\n },\n \"fees\": {\n \"amount\": 0,\n \"currency\": \"USD\",\n \"formatted\": \"$0.00\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bb57b0a-8915-43b2-83a0-0a68795cc60a", "name": "Shipping group or order not found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "A comma-separated list of related resources to include in the response.", "type": "text/plain" }, "key": "include", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Not Found\",\n \"detail\": \"Order not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df97356e-0c33-4a23-bcbf-0502164886c1", "name": "Update a shipping group for an order", "request": { "name": "Update a shipping group for an order", "description": { "content": "Update a shipping group for an order", "type": "text/plain" }, "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "orderID", "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "shippingGroupID", "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "42f798e1-3c5a-4ab4-9af2-ab07ab9001f6", "name": "Shipping group updated successfully", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"string\",\n \"relation\": \"string\",\n \"cart_id\": \"string\",\n \"order_id\": \"string\",\n \"shipping_type\": \"string\",\n \"tracking_reference\": \"string\",\n \"external_ref\": \"string\",\n \"address\": {\n \"country\": \"string\",\n \"first_name\": \"string\",\n \"last_name\": \"string\",\n \"line_1\": \"string\",\n \"postcode\": \"string\",\n \"region\": \"string\",\n \"company_name\": \"string\",\n \"line_2\": \"string\",\n \"city\": \"string\",\n \"county\": \"string\",\n \"phone_number\": \"string\",\n \"instructions\": \"string\"\n },\n \"delivery_estimate\": {\n \"start\": \"2022-01-13T05:25:39.165Z\",\n \"end\": \"1980-11-02T21:34:30.962Z\"\n },\n \"created_at\": \"2004-12-02T00:00:04.985Z\",\n \"updated_at\": \"1996-04-19T22:39:35.871Z\",\n \"relationships\": {\n \"cart\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"1443f6ff-7cc3-6a19-15d4-43fb0f603c03\"\n }\n },\n \"order\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"8c2c29c1-d8e3-7de5-5c47-b246870f5e76\"\n }\n }\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 3631,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 9071\n },\n {\n \"amount\": {\n \"amount\": 1898,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"id\": \"string\",\n \"code\": \"string\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": true,\n \"ordinal\": 2066\n }\n ],\n \"meta\": {\n \"shipping_display_price\": {\n \"total\": {\n \"amount\": 1792.9542924748644,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"base\": {\n \"amount\": 4126.934486687388,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 9901.496323221992,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"fees\": {\n \"amount\": 3391.3139788178405,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 585.0035496930839,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"total_display_price\": {\n \"with_tax\": {\n \"amount\": 2925.4614944046975,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_tax\": {\n \"amount\": 9460.695289653186,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"tax\": {\n \"amount\": 3289.481762307327,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"balance_owing\": {\n \"amount\": 4631.269695537788,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"paid\": {\n \"amount\": 4881.939933445616,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"authorized\": {\n \"amount\": 7227.279746213222,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"without_discount\": {\n \"amount\": 9764.781431787844,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping\": {\n \"amount\": 5467.963108835874,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"shipping_discount\": {\n \"amount\": 0,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"included\": {\n \"items\": [\n {\n \"type\": \"string\",\n \"id\": \"cdcb3506-4a12-a0f4-0afa-f7cb3abc488d\",\n \"quantity\": 1650.4510621227996,\n \"product_id\": \"43d945dc-32ed-fa43-fd7d-b41d69ea23c5\",\n \"subscription_offering_id\": \"b03fd3da-5bed-c535-2168-bde340cee50f\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 9600.881253646385,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 2324.6575024221806,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 7264.717169576469,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"da738fe0-f6d7-d06b-2fde-b6ac8388ffe0\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 41\n },\n {\n \"amount\": {\n \"amount\": 2304.7894811326187,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"6853c7cf-811b-5982-da7c-2ff71a2cab97\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 4865\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 7524.851639665872,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6927.666267744797,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 1937.2718471294825,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7072.917874628788,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 5373.499261614858,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4189.288208605974,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 597.5745658249255,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6657.445399555455,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 448.5472470252927,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7935.256618551001,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 7469.593486437287,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 2943.5117444957727,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 801.048290586368,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 1912.8473280678038,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 2024.4305787316796,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 2447.5625199781416,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 3249.6320121131107,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_3\": {\n \"amount\": 478.6132436967838,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 1319.9727274620686,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 3235.7479073928143,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 5479.299348562643,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_3\": {\n \"amount\": 9952.034275655758,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 4804.124098663938,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 4765.437599505544,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 7335.714949622514,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 5352.41890629004,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"ce33e58a-0957-6bde-2f74-2cde0089fe98\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 4099.960895010812\n },\n \"key_1\": {\n \"key_0\": 629.2818251224563\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": \"string\"\n },\n \"meta\": {\n \"key_0\": 6669\n },\n \"price\": {\n \"key_0\": false\n },\n \"relationships\": {\n \"key_0\": \"string\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 3848.717986001613,\n \"key_1\": 6025.9759917461815\n },\n \"meta\": {\n \"key_0\": 4332.987839337532\n },\n \"price\": {\n \"key_0\": 2220.2678867161253,\n \"key_1\": 577,\n \"key_2\": 90.97801613287437\n },\n \"relationships\": {\n \"key_0\": 6916\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 8377.66403689102,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 3226.4776876521896,\n \"type\": \"string\"\n }\n ]\n },\n \"key_1\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 5574.578779119923,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 3208.4480153369,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 5537,\n \"key_1\": 8828.461590739864\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": 6517.525037582553\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"aef7d331-9de0-2f2c-75da-4f5ec2dbdfcc\",\n \"quantity\": 5152.002115742551,\n \"product_id\": \"646ddb77-fee5-cad9-7c30-8eb6cd09a519\",\n \"subscription_offering_id\": \"3dd7adc2-c89a-183a-1345-79eec16ec068\",\n \"name\": \"string\",\n \"sku\": \"string\",\n \"location\": \"string\",\n \"unit_price\": {\n \"amount\": 5191.789530070659,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"value\": {\n \"amount\": 7787.14660221987,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"discounts\": [\n {\n \"amount\": {\n \"amount\": 6863.059114494943,\n \"currency\": \"string\",\n \"includes_tax\": false\n },\n \"code\": \"string\",\n \"id\": \"6fb659ee-3dfe-5a6a-4e72-652bcbcb2a20\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 8912\n },\n {\n \"amount\": {\n \"amount\": 9203.247633844318,\n \"currency\": \"string\",\n \"includes_tax\": true\n },\n \"code\": \"string\",\n \"id\": \"520fb74a-cbdc-96b3-fc8b-b3d6d8e47cef\",\n \"promotion_source\": \"string\",\n \"is_cart_discount\": false,\n \"ordinal\": 3981\n }\n ],\n \"links\": {},\n \"meta\": {\n \"display_price\": {\n \"with_tax\": {\n \"unit\": {\n \"amount\": 9760.93180761923,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 7559.732911203003,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_tax\": {\n \"unit\": {\n \"amount\": 8227.454329670909,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 6548.160520022412,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"tax\": {\n \"unit\": {\n \"amount\": 8377.0683837577,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4558.4470540144275,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discount\": {\n \"unit\": {\n \"amount\": 9221.338849212894,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4852.161542973366,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"without_discount\": {\n \"unit\": {\n \"amount\": 1625.3959787738913,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 441.33850605853286,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n },\n \"discounts\": {\n \"key_0\": {\n \"amount\": 2671.790342353706,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 8798.223724182388,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_1\": {\n \"amount\": 1828.3243224284206,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 7833.581081204823,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_1\": {\n \"amount\": 3103.018801133146,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"key_2\": {\n \"amount\": 4350.9895386353455,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"key_2\": {\n \"amount\": 4932.697937166015,\n \"currency\": \"string\",\n \"formatted\": \"string\",\n \"constituents\": {\n \"key_0\": {\n \"amount\": 148.2011595330812,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n }\n },\n \"original_price\": {\n \"unit\": {\n \"amount\": 9928.35827321542,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n },\n \"value\": {\n \"amount\": 4802.731894070669,\n \"currency\": \"string\",\n \"formatted\": \"string\"\n }\n }\n },\n \"timestamps\": {\n \"created_at\": \"string\",\n \"updated_at\": \"string\"\n }\n },\n \"relationships\": {\n \"cart_item\": {\n \"data\": {\n \"type\": \"string\",\n \"id\": \"6c4779bd-94e6-5d81-d5f0-51425c81848d\"\n }\n },\n \"taxes\": {\n \"data\": null\n },\n \"promotions\": {\n \"data\": null\n }\n },\n \"catalog_id\": \"string\",\n \"catalog_source\": \"string\",\n \"bundle_configuration\": {\n \"selected_options\": {\n \"key_0\": {\n \"key_0\": 1264.2272520563113,\n \"key_1\": 4968.772945774968,\n \"key_2\": 9895.815120415564,\n \"key_3\": 7163.460507084867\n },\n \"key_1\": {\n \"key_0\": 4705.0844333535215,\n \"key_1\": 5097.618334999359,\n \"key_2\": 7149.124948766499\n }\n },\n \"component_products\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 5950,\n \"key_1\": \"string\"\n },\n \"meta\": {\n \"key_0\": \"string\"\n },\n \"price\": {\n \"key_0\": false,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": true\n },\n \"relationships\": {\n \"key_0\": 1151.3187412639625,\n \"key_1\": 8121.503261524792\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"attributes\": {\n \"key_0\": 9356,\n \"key_1\": 3247.7402547322854\n },\n \"meta\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n },\n \"price\": {\n \"key_0\": false\n },\n \"relationships\": {\n \"key_0\": false,\n \"key_1\": false\n }\n }\n ]\n },\n \"components\": {\n \"key_0\": {\n \"name\": \"string\",\n \"options\": [\n {\n \"id\": \"string\",\n \"quantity\": 3216.892720275415,\n \"type\": \"string\"\n },\n {\n \"id\": \"string\",\n \"quantity\": 1040.0687107239714,\n \"type\": \"string\"\n }\n ]\n }\n },\n \"custom_inputs\": {\n \"key_0\": 8772,\n \"key_1\": 605.2546493368683,\n \"key_2\": 2827.1506670060953\n },\n \"custom_attributes\": {\n \"key_0\": {\n \"type\": \"string\",\n \"value\": false\n },\n \"key_1\": {\n \"type\": \"float\",\n \"value\": 7576.340661630256\n }\n },\n \"shipping_group_id\": \"string\",\n \"promotion_source\": \"string\",\n \"subscription_configuration\": {\n \"plan\": \"string\",\n \"pricing_option\": \"string\"\n }\n }\n ]\n },\n \"errors\": [\n {\n \"status\": 5096,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"3lOcSAfH@jrhMRUvAngGbNkAHLBEgACUXdsO.qsss\",\n \"component_product_id\": \"fb0e122a-fcf1-61a2-db2c-c8208fdb185a\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"status\": 6065,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"id\": \"string\",\n \"ids\": [\n \"string\",\n \"string\"\n ],\n \"item_ids\": [\n \"string\",\n \"string\"\n ],\n \"shipping_group_id\": \"string\",\n \"shipping_group_ids\": [\n \"string\",\n \"string\"\n ],\n \"cart_id\": \"string\",\n \"code\": \"string\",\n \"order_id\": \"string\",\n \"sku\": \"string\",\n \"email\": \"shavty@eUNtfDcZjTegzErdWpAzYFPhtCDb.qoqk\",\n \"component_product_id\": \"7a43893b-a6c9-f4a5-4dac-ded7a2a1bfcf\",\n \"error-meta-key\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7e9d9f6-e2fa-44b2-8850-c74459c0234a", "name": "Invalid request", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Date Logic Discrepancy\",\n \"detail\": \"The start date cannot occur after the end date\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1dd74b89-9b3b-4389-967a-c166b566e617", "name": "Shipping group or order not found", "originalRequest": { "url": { "path": [ "v2", "orders", ":orderID", "shipping-groups", ":shippingGroupID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the order", "type": "text/plain" }, "type": "any", "value": "string", "key": "orderID" }, { "disabled": false, "description": { "content": "(Required) The ID of the shipping group", "type": "text/plain" }, "type": "any", "value": "string", "key": "shippingGroupID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"shipping_group\",\n \"shipping_type\": \"express\",\n \"tracking_reference\": \"TRACK456\",\n \"address\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"phone_number\": \"(555) 555-1234\",\n \"company_name\": \"ACME Corp\",\n \"line_1\": \"123 Main St\",\n \"line_2\": \"Suite 100\",\n \"city\": \"Portland\",\n \"postcode\": \"97201\",\n \"county\": \"Multnomah\",\n \"country\": \"US\",\n \"region\": \"Oregon\",\n \"instructions\": \"Leave at front door\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Group not found\",\n \"detail\": \"Group with ID [7cfa5b07-092e-4dbe-bbad-55a771a34117] not found for order [abc123]\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Currencies", "description": ":::caution\n\n- There is a hard limit of 10 currencies per store.\n\n:::\n", "item": [ { "id": "eb59a1cc-58af-4183-9bf5-92a1eb60a039", "name": "Get all Currencies", "request": { "name": "Get all Currencies", "description": { "content": "Fetch all currencies.\n", "type": "text/plain" }, "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b8b72d53-3980-4b8e-b999-b628a35a0f65", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"type\": \"currency\",\n \"code\": \"GBP\",\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"decimal_point\": \".\",\n \"thousand_separator\": \",\",\n \"decimal_places\": 2,\n \"default\": true,\n \"enabled\": true,\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\",\n \"updated_at\": \"2023-11-07T23:04:18.845Z\"\n },\n \"owner\": \"store\"\n }\n },\n {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"type\": \"currency\",\n \"code\": \"GBP\",\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"decimal_point\": \".\",\n \"thousand_separator\": \",\",\n \"decimal_places\": 2,\n \"default\": true,\n \"enabled\": true,\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\",\n \"updated_at\": \"2023-11-07T23:04:18.845Z\"\n },\n \"owner\": \"store\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74d2ac16-53d3-48e3-b2dd-0712f468fe77", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"The request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16f70cf6-ecf5-419f-8902-6e397cf58ea2", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4a2960b9-67e7-45d3-9cf5-51d0b7c287dd", "name": "Create a Currency", "request": { "name": "Create a Currency", "description": { "content": "Create a currency.\n", "type": "text/plain" }, "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "[\n {\n \"data\": {\n \"code\": \"GBP\",\n \"decimal_places\": 2,\n \"decimal_point\": \".\",\n \"default\": true,\n \"enabled\": true,\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"thousand_separator\": \",\",\n \"type\": \"currency\"\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1d123ef4-8e76-43c4-bc5d-cb0a6f27c08d", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"code\": \"GBP\",\n \"decimal_places\": 2,\n \"decimal_point\": \".\",\n \"default\": true,\n \"enabled\": true,\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"thousand_separator\": \",\",\n \"type\": \"currency\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"type\": \"currency\",\n \"code\": \"GBP\",\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"decimal_point\": \".\",\n \"thousand_separator\": \",\",\n \"decimal_places\": 2,\n \"default\": true,\n \"enabled\": true,\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\",\n \"updated_at\": \"2023-11-07T23:04:18.845Z\"\n },\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01ba7f58-be13-4b64-9ab1-5d7332f75310", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"code\": \"GBP\",\n \"decimal_places\": 2,\n \"decimal_point\": \".\",\n \"default\": true,\n \"enabled\": true,\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"thousand_separator\": \",\",\n \"type\": \"currency\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Currency already exists\",\n \"detail\": \"The specified currency code already exists\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "307f82cd-441b-432a-a8bc-795448f13d22", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"code\": \"GBP\",\n \"decimal_places\": 2,\n \"decimal_point\": \".\",\n \"default\": true,\n \"enabled\": true,\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"thousand_separator\": \",\",\n \"type\": \"currency\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 422,\n \"title\": \"Currency limit reached\",\n \"detail\": \"You have reached the maximum allowed currency limit of 10\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a5e8730a-7781-4636-9db4-4a6659c90c05", "name": "Get a Currency", "request": { "name": "Get a Currency", "description": { "content": "Fetch a currency by its ID.\n", "type": "text/plain" }, "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "currencyID", "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "470831e2-be3c-4dbd-aafe-e3e94203aee4", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"type\": \"currency\",\n \"code\": \"GBP\",\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"decimal_point\": \".\",\n \"thousand_separator\": \",\",\n \"decimal_places\": 2,\n \"default\": true,\n \"enabled\": true,\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\",\n \"updated_at\": \"2023-11-07T23:04:18.845Z\"\n },\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b1fc541-1325-4d10-aa54-677e8950281b", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"The request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec28bb58-88ac-4a14-a237-9961c29e83d4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d98e655-eebc-4ef3-a19e-85f39f72d12c", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Currency not found\",\n \"detail\": \"The requested currency could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b086be3a-8539-46b2-89be-1bc11db51311", "name": "Update a Currency", "request": { "name": "Update a Currency", "description": { "content": "Update a currency.\n", "type": "text/plain" }, "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "currencyID", "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "[\n {\n \"data\": {\n \"default\": true\n }\n }\n]", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6c9acd02-34f1-450a-a3aa-192191b3973f", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0c45e4ec-26e0-4043-86e4-c15b9cf985a0\",\n \"type\": \"currency\",\n \"code\": \"GBP\",\n \"exchange_rate\": 1,\n \"format\": \"£{price}\",\n \"decimal_point\": \".\",\n \"thousand_separator\": \",\",\n \"decimal_places\": 2,\n \"default\": true,\n \"enabled\": true,\n \"links\": {\n \"self\": \"string\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\",\n \"updated_at\": \"2023-11-07T23:04:18.845Z\"\n },\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6b651d5-6e75-4812-9781-568d6a1d2500", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"The request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89675363-3df5-4dda-8f8d-f6d58b60acd5", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34e9cccf-451d-4111-a51a-2cf8d2ecbcb5", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the requested currency.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Currency not found\",\n \"detail\": \"The requested currency could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "295b2c28-4fbf-4bb6-adbf-c4ed8c8cec24", "name": "Delete a Currency", "request": { "name": "Delete a Currency", "description": { "content": "Delete a currency.\n\n:::caution\n\n- You can’t delete a default currency.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "currencyID", "disabled": false, "description": { "content": "(Required) The ID for the Currency to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "5ea98b22-6d69-4607-a62d-551d7a0719f6", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the Currency to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "02acb599-762f-4f7b-baa8-422b79005af2", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the Currency to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Bad Request\",\n \"detail\": \"The request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be2e6002-4e73-4b66-b4fb-567990a4c2ec", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "currencies", ":currencyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID for the Currency to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "currencyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Currency not found\",\n \"detail\": \"The requested currency could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom APIs", "description": "Custom APIs allow you to extend the capabilities of Commerce. With Custom APIs, you can efficiently manage large data sets while benefiting from both simple and complex multidimensional filtering options. Combining Custom APIs with [Composer](/docs/composer/index) enables you to deploy custom behaviors and integrations, allowing you to implement capabilities unique to your business without having to build and host that functionality from scratch.\n\nA Custom API is composed of one or more [Custom Fields](/docs/api/commerce-extensions/custom-fields) and allows you to create [Entries](/docs/api/commerce-extensions/custom-api-entries). In database terms, a Custom API can be thought of as a table, with fields representing the columns of the table, and entries serving as the database records.\n\n## Custom APIs vs Non-Core Flows\n\nCustom APIs are the next generation of Non-Core Flows. Here is a comparison of current features of Non-Core Flows and Custom APIs. This will be updated as we release more capabilities.\n\n| Feature | Non-Core Flows | Commerce Extensions |\n|---------------------------------------------------------------------------------------------------------------------------|----------------|----------------------------------------------------------------|\n| Build new APIs | ✅ | ✅ |\n| Access Level | Implicit | [Customizable](/docs/api/permissions/custom-api-role-policies) |\n| [Filtering](/docs/api/commerce-extensions/list-custom-api-entries#filtering) | ⛔️ | ✅ |\n| [Sorting](/docs/api/commerce-extensions/list-custom-api-entries#sorting) | ⛔️ | ✅ |\n| [Events](/docs/api/commerce-extensions/custom-api-entries#events) | ⛔️ | ✅ |\n| [Conditional Updates](/guides/How-To/commerce-extensions/create-a-multilocation-inventories-resource#conditional-updates) | ⛔️ | ✅ |\n\nThe [Custom Fields Overview](/docs/api/commerce-extensions/custom-fields) lists the comparison of different types and validation available in Custom APIs vs Non-Core Flows.\n", "item": [ { "id": "ca476120-7553-4434-b3df-492d4e367ba3", "name": "Create a Custom API", "request": { "name": "Create a Custom API", "description": { "content": "Create a Custom API", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"api_type\": \"wishlist_ext\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "79459570-f070-40fa-8cee-31ababa8b094", "name": "A Custom API", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"api_type\": \"wishlist_ext\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"693971dd-e6b2-49a8-831b-52dc99620afa\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"gk6p4ap_ion36007u2temw8u\",\n \"api_type\": \"kx677abha7mmbmp5msl5p_ag_ext\",\n \"allow_upserts\": false,\n \"presentation\": {\n \"page\": \"string\",\n \"section\": null\n },\n \"links\": {\n \"self\": \"https://jItKjNsRxyKczURrQ.jrqu3i,4Z-zNQeIpRZYKMLw-XUBhGtSzOEgh1\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcfe5935-ead5-472d-8643-39eb980e539e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"api_type\": \"wishlist_ext\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5b06698-fe97-404f-9371-cd9c94223cf6", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"api_type\": \"wishlist_ext\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e817c36e-88ab-433b-be9a-3808c099206c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"api_type\": \"wishlist_ext\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "204e3cbf-c819-4ddc-ab75-9ebbfecb4f15", "name": "List Custom APIs", "request": { "name": "List Custom APIs", "description": { "content": "Retrieves a list of Custom APIs\n\n## Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) Custom APIs:\n\n| Attribute | Operators | Example |\n|---------------------|-------------------------------|-----------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,7e067539-6f6c-46e1-8c55-940031b36c6a)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n| `api_type` | `eq`,`like`,`in` | `like(api_type,wishlist*)` |\n| `description` | `eq`,`like` | `like(description,*list*)` |\n| `name` | `eq`,`like` | `eq(name,\"Wishlist\")` |\n| `slug` | `eq`,`like`,`in` | `like(slug,*lists)` |\n| `presentation.page` | `ilike` | `ilike(presentation.page,Home)` |\n\n## Sorting\nThe following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with `-`, for example, `-updated_at`. The default sort order is `created_at` in descending order.\n- `id`\n- `created_at`\n- `updated_at`\n- `api_type`\n- `name`\n- `slug`\n", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom APIs will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,api_type,-api_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "72dc0618-18ca-4036-ad22-4a5a1550552e", "name": "List of Custom APIs", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom APIs will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,api_type,-api_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"552e2022-81c3-6333-1276-088fc8da13dd\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"ickb545pkj\",\n \"api_type\": \"uh68v4h593f6i438_ext\",\n \"allow_upserts\": false,\n \"presentation\": {\n \"page\": null,\n \"section\": null\n },\n \"links\": {\n \"self\": null\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"api_location\"\n }\n ]\n }\n }\n },\n {\n \"id\": \"2a983299-a4c5-7100-476d-bba3023e91a4\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"xg13f4rv-izgacll0r84-doeqg_zjhpzkh_zqo8v\",\n \"api_type\": \"0da_ext\",\n \"allow_upserts\": false,\n \"presentation\": {\n \"page\": null,\n \"section\": \"string\"\n },\n \"links\": {\n \"self\": \"http://ylotrZFWwTsB.eawouvR27yu1hJp1rpT2A0VbQ0+1mVD3U0Ue+3eIl\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 3266,\n \"total_method\": \"lower_bound\"\n },\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"http://kVKQdFRBCxiXJCasnuDhubvEYgtAEWF.qrfopBM+0lo-9YpEAU0KSXGDwpiUBRhLTeF-+0I\",\n \"first\": null,\n \"last\": \"http://VEPjFrSzebkvMfMYoiJcaKHzM.jbavOz1lSuRXNn38QnY,zKnSCulBc1wFmXWB5kuXzt5WfvyMWujLbik8af.9sKB0\",\n \"next\": null,\n \"prev\": \"https://gbym.jfttWsruPv1xfkmgGqxkcvxIK7ZBYR65TIvbXc1IMrYIoLzaPlXcNJZltC+-sJIhlKNLFcJ.g\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82d60f7b-b389-40a1-8dee-03c850b967e9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom APIs will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,api_type,-api_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2249b991-1744-4bed-a434-090abf883d37", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom APIs will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,api_type,-api_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "db8d8f52-623e-4979-bc76-5929a0fd349c", "name": "Get a Custom API", "request": { "name": "Get a Custom API", "description": { "content": "Get a Custom API", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ac3afc83-abd4-44d4-886f-a05277606a55", "name": "A Custom API", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"693971dd-e6b2-49a8-831b-52dc99620afa\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"gk6p4ap_ion36007u2temw8u\",\n \"api_type\": \"kx677abha7mmbmp5msl5p_ag_ext\",\n \"allow_upserts\": false,\n \"presentation\": {\n \"page\": \"string\",\n \"section\": null\n },\n \"links\": {\n \"self\": \"https://jItKjNsRxyKczURrQ.jrqu3i,4Z-zNQeIpRZYKMLw-XUBhGtSzOEgh1\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b523f95-539e-4ef1-bb10-291f7e288b3c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2482a7af-a23f-4e10-9823-7a0e1d503926", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1208f3cd-da67-415e-b9c9-ef3218249d3a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7ca300f4-e643-46c6-b279-8add54c034c4", "name": "Update a Custom API", "request": { "name": "Update a Custom API", "description": { "content": "Update a Custom API", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1f818027-76ca-4871-84d4-f01c48a3146e", "name": "A Custom API", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"693971dd-e6b2-49a8-831b-52dc99620afa\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"gk6p4ap_ion36007u2temw8u\",\n \"api_type\": \"kx677abha7mmbmp5msl5p_ag_ext\",\n \"allow_upserts\": false,\n \"presentation\": {\n \"page\": \"string\",\n \"section\": null\n },\n \"links\": {\n \"self\": \"https://jItKjNsRxyKczURrQ.jrqu3i,4Z-zNQeIpRZYKMLw-XUBhGtSzOEgh1\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n },\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "670c374e-1bf0-49e5-8411-1b3f0b100c10", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e89c0e01-b754-46f4-9d82-5927e8cff889", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11b14ba1-f72f-4425-b885-8b5450a26e8b", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e898122f-915c-4139-a681-d75ddbdd0338", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api\",\n \"name\": \"Wishlists\",\n \"description\": \"Specifies the description for this Custom API.\",\n \"slug\": \"wishlists\",\n \"relationships\": {\n \"parent_apis\": {\n \"data\": [\n {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"custom_api\"\n }\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bfb0b1d9-3821-4e0a-8770-12633e771b7e", "name": "Delete a Custom API", "request": { "name": "Delete a Custom API", "description": { "content": "Delete a Custom API", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "9e39bdb5-abe1-4005-a081-55da3ed11ad7", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "53f0b454-5ff1-4c5f-a44d-888d81e7447d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67b3245c-521e-41b6-ae61-a32170873e11", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8deb5b90-382f-421f-a926-32788d4b4156", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5e93b08f-1cb2-4dce-9e99-29962f0813a7", "name": "Get OpenAPI Specification", "request": { "name": "Get OpenAPI Specification", "description": { "content": "Generates an OpenAPI specification based on the Custom APIs and Custom Fields configured for the current store.\nThis dynamically generated specification provides typed schemas for the `/v2/extensions/` endpoints.\n", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "specifications", "openapi" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "390c3f9f-eea9-4e9b-9e77-0d99ab4ca5bf", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "specifications", "openapi" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key_0\": 6259,\n \"key_1\": true,\n \"key_2\": 1931.5816038913836\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bf33771-d517-4ea9-a76e-5fd593b1669b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "specifications", "openapi" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6ae545c-7965-4c44-8bfa-07641f9d6d30", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "specifications", "openapi" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom Fields", "description": "A Custom Field represents a single field of data (for example a Product Rating). A Custom API is composed of one or more Custom Fields.\n\nHere is a comparison of different types and validation available in Custom APIs vs Non-Core Flows.\n\n| Feature | Non-Core Flows | Commerce Extensions |\n|-----------------------------------------------|----------------|--------------------------------------------|\n| Data Type: String | ✅ | ✅ |\n| Data Type: Integer | ✅ | ✅ |\n| Data Type: Float | ✅ | ✅ |\n| Data Type: Boolean | ✅ | ✅ |\n| Data Type: List | ⛔ | ✅ |\n| Data Type: Any | ⛔ | ✅ |\n| Data Type: Date & Time | ✅ | ✅ Replaced by Regex Validation (See Below) |\n| Data Type: One To Many | ✅ | Planned |\n| Validation: Regular Expression | ⛔️ | ✅ |\n| Validation: Slug/Email | ✅ | ✅ Replaced by Regex Validation (See Below) |\n| Validation: Min/Max Value | ✅ | ✅ |\n| Validation: Enum(String) | ✅ | ✅ Replaced by Regex validation (See Below) |\n| Validation: Enum(Float/Integer) | ✅ | ⛔️ |\n| Validation: Allow null values | ⛔ | ✅ |\n| Validation: Unique(String) | ⛔ | ✅ |\n| Validation: Unique Case Insensitivity(String) | ⛔ | ✅ |\n| Validation: Immutable | ⛔ | ✅ |\n\n## Validation\n\nWhen [creating](/docs/api/commerce-extensions/create-a-custom-field#request) or [updating](/docs/api/commerce-extensions/update-a-custom-field#request) a Custom Field, `validation` can be used to limit the values that may be stored in the corresponding Custom API Entry.\n\n:::note\n\nAll validation changes, such as those to `allow_null_values` and any type specific rules, apply to new entries only. Existing Custom API Entry records are unaffected until updated.\n\n:::\n\n### Integer Validation\n- `min_value`: Specifies the minimum whole number that can be stored. If set, it must be less than `max_value`.\n- `max_value`: Specifies the maximum whole number that can be stored. If set, it must be greater than `min_value`.\n\nsample integer validation object:\n\n```json\n{\n \"validation\": {\n \"integer\": {\n \"min_value\": 0,\n \"max_value\": 32\n }\n }\n}\n```\nEven if no validation is set, field_type `integer` only supports values between -2^53+1 and 2^53+1. This is because the JSON format doesn't guarantee that values outside this range are portable ([Source](https://datatracker.ietf.org/doc/html/rfc7159#section-6)).\n\n\n\n### Float Validation\n- `min_value`: Specifies the minimum number that can be stored. If set, it must be less than `max_value`.\n- `max_value`: Specifies the maximum number that can be stored. If set, it must be greater than `min_value`.\n\nsample float validation object:\n\n```json\n{\n \"validation\": {\n \"float\": {\n \"min_value\": 0.01,\n \"max_value\": 32.01\n }\n }\n}\n```\n\nThe `float` field_type cannot accurately represent some numbers and so using very small or large numbers might lose precision. We recommend that API clients use either the `integer` field_type if applicable , or the `string` data type if perfect precision or recall is required.\n\n### String Validation\n- `min_length`: Specifies the minimum number of characters that can be stored. If set, it must be greater than 0 and less than `max_length`.\n- `max_length`: Specifies the maximum number of characters that can be stored. If set, it must be greater than 0 and `min_length`.\n- `regex`: An [RE2](https://github.com/google/re2/wiki/Syntax) regular expression used to restrict the specific characters that can be stored. It must be less than 1024 characters.\n- `unique`: Specifies whether the field must have unique constraint or not. It must be `yes` or `no`.\n- `unique_case_insensitivity`: Applies when `unique` is set to `yes`. It controls whether values with different cases (for example, `ABC` and `abc`) should conflict. It must be `true` or `false`.\n sample string validation object:\n\n```json\n{\n \"validation\": {\n \"string\": {\n \"min_length\": 0,\n \"max_length\": 64,\n \"regex\": \"^.+\\\\.(jpg|jpeg|png|gif|pdf)$\",\n \"unique\": \"yes\"\n \"unique_case_insensitivity\": true\n }\n }\n}\n```\nEven if no validation is set, field_type `string` only supports values that are up to `65535` characters long.\n\n#### Date & Time Values With Regular Expressions\n\nWhile Commerce Extensions does not have a native date or time type, you can none-the-less use these values in Commerce Extensions, by using the `string` field type and `regex` validation. To ensure that\nordering is handled properly you should follow the guidance in [RFC 3339 - Section 5.1 Ordering](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.1), namely store the fields in order of least to most precise,\nand in the same timezone, this will ensure that comparison operators (e.g., `gt`) and sorting, work as expected, for example the following regex will force all values to be in seconds in UTC: `^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$`\n\nOne thing to keep in mind is that some libraries, especially when dealing with sub-seconds might only display them if they are non-zero, and you will want to ensure that they are fully padded to the same length.\n\n#### Enum Values with Regular Expressions\n\nYou can ensure that only some values are allowed using the regular expression `^(alpha|bravo|charlie)$`.\n\n#### Slug Values with Regular Expressions\n\nSlugs can be replaced with the regular expression `^[a-z][a-z0-9-]*$`, this will ensure that the field starts with a lower case letter, and then has lower case letters, numbers or hyphens. You can tweak this regular expression as needed to suit your needs.\n\n### Email Validation with Regular Expressions\n\nE-mails can be tricky to validate properly, especially because many services _accept_ e-mails that are not valid, and reject e-mail addresses that are technically valid. Additionally, your own capabilities and purposes might inform your decision (e.g., if you support [i18n addresses](https://datatracker.ietf.org/doc/html/rfc6530) or don't then the set of allowed e-mails changes).\n\n### List Validation\n- `min_length`: Specifies the minimum number of elements that must be in the list.\n- `max_length`: Specifies the maximum number of elements allowed in the list. The maximum supported value is 1000.\n- `allowed_type`: Specifies the primitive type that all elements in the list must be. Valid values are `string`, `integer`, `boolean`, `float`, or `any`. The default is `any`, which allows mixed types. This value cannot be changed after the field is created.\n\nsample list validation object:\n\n```json\n{\n \"validation\": {\n \"list\": {\n \"min_length\": 1,\n \"max_length\": 100,\n \"allowed_type\": \"string\"\n }\n }\n}\n```\n\n### Any Validation\n\nThe `any` field type allows storing arbitrary JSON values including objects, arrays, strings, numbers, booleans, and null. When updating an entry, the `any` field value is completely replaced, not merged. Filtering is not supported on `any` fields.\n\nsample any validation object:\n\n```json\n{\n \"validation\": {\n \"any\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n}\n```\n\n### Null Values\n\nAll Custom Fields can be configured to restrict the storage of `null` values for that field on a Custom API Entry. By default, this is `true`.\n\nsample validation object :\n\n```json\n{\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": false,\n \"immutable\": false\n }\n }\n}\n```\n\n### Immutable\n\nWhen [creating](/docs/api/commerce-extensions/create-a-custom-field#request) a Custom Field, it can be configured to be `immutable`. When set to true, the value of this field can be specified only during POST requests and cannot be modified during PUT requests. By default, this is `false`.\n\nsample validation object :\n\n```json\n{\n \"validation\": {\n \"boolean\": {\n \"immutable\": false\n }\n }\n}\n```\n\n## Presentation\n\nWhen [creating](/docs/api/commerce-extensions/create-a-custom-field#request) or [updating](/docs/api/commerce-extensions/update-a-custom-field#request) a Custom Field, `presentation` can be used to influence the layout and order of fields within Commerce Manager. It does not affect the order of keys within JSON, nor influence any behaviour outside of Commerce Manager.\n\n## Reserved Slugs\n\nThe following values cannot be used as a `slug` in a Custom Field.\n\n- slug\n- type\n- id\n- meta\n- created_at\n- updated_at\n- links\n- relationships\n- attributes\n- attribute\n- dimension\n- dimensions\n- weight\n- weights\n", "item": [ { "id": "0b11127e-d35f-4585-8203-21438cadb2d8", "name": "Create a Custom Field", "request": { "name": "Create a Custom Field", "description": { "content": "Create a Custom Field", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "88ee8c9d-7318-4f9b-8467-72f95e8b3bfe", "name": "A Custom Field", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"859aeba1-03c2-4822-bd4c-89afce93d7eb\",\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n },\n \"links\": {\n \"self\": \"/v2/settings/extensions/custom-apis/3fa85f64-5717-4562-b3fc-2c963f66afa6/fields/859aeba1-03c2-4822-bd4c-89afce93d7eb\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11171ab4-ce24-4e37-bfcc-f0d81889aa61", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3e01352-8fd1-47f5-b18c-dc67649c8265", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ae48bdf-e970-40c1-8a80-ff60a6e5a493", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1034a43e-d393-42ed-bb48-b9dc1995c4d1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6a0b2ad4-9e7a-46c4-a77f-c830a18e2882", "name": "List Custom Fields", "request": { "name": "List Custom Fields", "description": { "content": "Retrieves a list of Custom Fields\n\n## Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) Custom Fields:\n\n| Attribute | Operators | Example |\n|---------------|-------------------------------|-----------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,859aeba1-03c2-4822-bd4c-89afce93d7eb)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n| `description` | `eq`,`like` | `like(description,*confidential*)` |\n| `field_type` | `eq`,`in` | `eq(field_type,string)` |\n| `name` | `eq`,`like` | `eq(name,\"Last Name\")` |\n| `slug` | `eq`,`like`,`in` | `like(slug,*private*)` |\n\n## Sorting\nThe following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with `-`, for example, `-updated_at`. The default sort order is `created_at` in descending order.\n- `id`\n- `created_at`\n- `updated_at`\n- `field_type`\n- `name`\n- `slug`\n", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom Fields will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,field_type,-field_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "61105ea9-ef73-482a-a588-f11d78626021", "name": "List of Custom Fields", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom Fields will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,field_type,-field_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"f71ad181-76f4-3b51-c574-df8c56413429\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"string\",\n \"field_type\": \"list\",\n \"use_as_url_slug\": true,\n \"presentation\": {\n \"sort_order\": 10\n },\n \"links\": {\n \"self\": \"http://VBnqfeRZopWNehyQD.figEM0xPACemdwjRwrW7-hB4PyHNaMlJcmwmWMdjl0dVSG2KBFMHWRMwH5yGmUVk4CQEfM.ILf8AChvhCFp+EgG4T-\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n },\n {\n \"id\": \"a0e60ff3-9958-12f4-8cbc-ccf8645ea825\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"slug\": \"string\",\n \"field_type\": \"list\",\n \"use_as_url_slug\": true,\n \"presentation\": {\n \"sort_order\": 10\n },\n \"links\": {\n \"self\": \"http://GqA.zbnOpaIjO6TokMscEUJpND.QGoywG2nB1bB8U6jcp7DLXig\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 6560,\n \"total_method\": \"exact\"\n },\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": null,\n \"first\": null,\n \"last\": \"https://LLFfTz.ultAQ7OH2-LtEoN4-Zh0xnjaNlN6GF9wGAc4sokO\",\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "626c8f90-9784-42b3-a9d0-1af2cd4ee744", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom Fields will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,field_type,-field_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "634e9e6c-cd64-43ee-9ac7-bfc682223c92", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom Fields will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,field_type,-field_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6d8b0d3-29c2-4eff-bfba-ca20f55b9a27", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom Fields will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,field_type,-field_type,name,-name,slug,-slug)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "acc2b6f2-8c55-4822-840f-aae9fdeb1183", "name": "Get a Custom Field", "request": { "name": "Get a Custom Field", "description": { "content": "Get a Custom Field", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1509df34-88b6-45ce-86c4-f518771ad211", "name": "A Custom Field", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"859aeba1-03c2-4822-bd4c-89afce93d7eb\",\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n },\n \"links\": {\n \"self\": \"/v2/settings/extensions/custom-apis/3fa85f64-5717-4562-b3fc-2c963f66afa6/fields/859aeba1-03c2-4822-bd4c-89afce93d7eb\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e09fd870-4de0-402a-8e91-e2b57008d664", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e29c364d-cef0-4988-9d19-3debb3b14f29", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96baa108-ed5a-4ae5-aee8-b38e9131c997", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bba0008d-581a-465a-843d-12b8b18bf650", "name": "Update a Custom Field", "request": { "name": "Update a Custom Field", "description": { "content": "Update a Custom Field", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ea7854b1-ece0-46c4-958e-3a338c277187", "name": "A Custom Field", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"859aeba1-03c2-4822-bd4c-89afce93d7eb\",\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"field_type\": \"boolean\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n },\n \"links\": {\n \"self\": \"/v2/settings/extensions/custom-apis/3fa85f64-5717-4562-b3fc-2c963f66afa6/fields/859aeba1-03c2-4822-bd4c-89afce93d7eb\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cddc6ee4-2f7d-4f6f-ba03-fb2a048919df", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "527b36e9-2978-4e5f-b795-0e35e73eb1e0", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e10ebadb-770b-4b1f-a536-39c2229a591d", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4c547f4-d45f-44db-87b2-97f03e087a96", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_field\",\n \"name\": \"Keep Purchased Items\",\n \"description\": \"This field stores whether or not to keep purchased items on the wishlist.\",\n \"slug\": \"keep_purchased\",\n \"validation\": {\n \"boolean\": {\n \"allow_null_values\": true,\n \"immutable\": false\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7e969c06-590e-465e-a463-4bd93e4cf92b", "name": "Delete a Custom Field", "request": { "name": "Delete a Custom Field", "description": { "content": "Delete a Custom Field", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "a667d155-00f5-438e-bd1c-0d6a3a3fbf1c", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7ce9c4ed-46f2-4a4a-ba17-c26fc2d4945e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da53cc38-33b1-43bc-bcee-c25708ab7954", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72881973-da33-4586-a5c5-61faf69dbea4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "fields", ":custom-field-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom Field.", "type": "text/plain" }, "type": "any", "value": "859aeba1-03c2-4822-bd4c-89afce93d7eb", "key": "custom-field-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom API Entries", "description": "A **Custom API Entry** is a specific instance of a resource, such as a single wishlist in a Custom API for wishlists.\n\nCustom API Entries can be accessed in two different ways, via the **extension** endpoint, or the **settings** endpoint:\n\n* Extension Endpoint: `/v2/extensions/{custom-api-slug}` - This is the primary endpoint created for use. Most clients should use this endpoint as it adheres to the semantics of the configuration. Retrieve the [OpenAPI Specifications](/docs/api/commerce-extensions/get-open-api-specification) to learn how to interact with this endpoint.\n* Settings Endpoint: `/v2/settings/extensions/custom-apis/{custom-api-id}/entries/` - This endpoint should only be used in cases where you want to interact with your Custom APIs in a generic way in an admin capacity.\n\nCurrently, the distinction between these endpoints is minimal. The extension endpoint uses a slug in the URL path, and the settings endpoint uses an ID. For most use cases involving the new Custom API, we recommend using the extension endpoint.\n\nConceptually, the settings endpoint is analogous to reflection in most programming languages. You use it when you want to operate in a generic way. For example, we used the settings endpoint to build Commerce Manager. Another example is if you need to import and export various types of data from CSV files. Instead of writing multiple scripts for different extension endpoints, you can write one script that operates on the settings endpoint.\n\n## Events\n\nYou can integrate Commerce Extensions with your external systems by observing the appropriate events. For more information, see [Integrations](/docs/api/integrations/integrations-introduction).\n\nGiven you have a Custom API with `api_type` of `wishlist_ext` and you want to perform additional processing when an action is taken, like when a wishlist is created:\n\n```bash\ncurl -X POST https://useast.api.elasticpath.com/v2/extensions/wishlists \\\n -H \"Authorization: Bearer XXXX\" \\\n -H \"Content-Type: application/json\" \\\n -d $ {\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false\n }\n }\n```\n\nWhen you [create an integration](/docs/api/integrations/create-integration) with `wishlist_ext.created` in `observes` field.\nThen the configured `webhook` or `aws_sqs` will receive the appropriate message.\n\nYou can configure integrations to observe the following events for your Custom API Entries:\n* Created\n* Updated\n* Deleted\n", "item": [ { "id": "ab5b6c0a-a098-44fd-89d9-a54be4c13fcc", "name": "Create a Custom API Entry", "request": { "name": "Create a Custom API Entry", "description": { "content": "Create a Custom API Entry", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ffd76933-f38a-4e76-a7ea-1ea91c340d0e", "name": "A Custom API Entry", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "A unique identifier representing the current version of the resource. When the resource changes, the ETag value will also change. The ETag hash will be the same value as `etag_id`, and is marked as a weak entity tag string. For example: etag: W/\"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\", etag_id: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\n", "type": "text/plain" }, "key": "ETag", "value": "string" } ], "body": "{\n \"data\": {\n \"id\": \"7e067539-6f6c-46e1-8c55-940031b36c6a\",\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ],\n \"links\": {\n \"self\": \"/v2/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"resource_version\\\"\": 0,\n \"data_size\\\"\": 6,\n \"etag_id\\\"\": \"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "594e8976-18fd-4c80-9fab-bf785de342bd", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1e7b18e-60b8-4ef1-b6f1-bfb41e68ceff", "name": "Forbidden. You do not have permission to access this resource.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"You do not have permission to access this resource.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21412e47-7a27-4bf1-aa6b-061a6e7d3a0e", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba86631e-3739-4091-9f62-b9c7c3d81bce", "name": "Payload Too Large.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Request Entity Too Large\",\n \"status\": \"413\",\n \"detail\": \"Maximum entry size reached.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58dd0ccc-d74c-49a2-bbbb-a48bf417385a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ad14f67-34a2-4553-8134-e051d5025cdd", "name": "The service is temporarily unavailable. This request can be safely retried.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"An unknown error occurred\",\n \"status\": \"503\",\n \"title\": \"Service Unavailable\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8b772c1a-833e-4ef5-b440-b3a965ec0b08", "name": "List Custom API Entries", "request": { "name": "List Custom API Entries", "description": { "content": "Retrieves a list of Custom API Entries\n\n## Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) all Custom API Entries:\n\n| Attribute | Operators | Example |\n|---------------|-------------------------------|-----------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,859aeba1-03c2-4822-bd4c-89afce93d7eb)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n\nThe following operators and attributes may be available for filtering Custom API Entries depending on how the [Custom Fields](/docs/api/commerce-extensions/create-a-custom-field) for that Custom API are configured.\n\n| Field type | Operators |\n|------------|-----------------------------------------------------------|\n| `string` | `lt`,`le`,`eq`,`gt`,`ge`,`in`,`is_null`,`like` |\n| `integer` | `lt`,`le`,`eq`,`gt`,`ge`,`in`,`is_null` |\n| `float` | `lt`,`le`,`gt`,`ge`,`in`,`is_null` |\n| `boolean` | `eq`,`is_null` |\n| `list` | `contains`,`contains_any`,`is_null`,`contains_all`(typed) |\n\nGiven there is a Custom Field with `\"slug\": \"name\"` and `\"field_type\": \"string\"`.\n\nWhen you get all Custom API Entries with query parameter: `?filter=like(name,*wish*)`.\n\nThen you will get all Custom API Entries where `name` contains the string `wish`.\n\n:::warn\n\nFor performance reasons, the `is_null` search operator will **NOT** match entries for a custom_field where the custom_entry was last updated before the custom_field existed. Updating the entry will cause the field to exist and match properly.\n\n:::\n\n\n## Sorting\nThe following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with `-`, for example, `-updated_at`. The default sort order is `created_at` in descending order.\n- `id`\n- `created_at`\n- `updated_at`\n", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d0233431-391e-4006-8661-11a4e61a6bcb", "name": "List of Custom API Entries", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"15c4b19b-2fdf-787f-f8e9-5fd3880625c6\",\n \"type\": \"string\",\n \"links\": {\n \"self\": null\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"data_size\": 6,\n \"resource_version\": 4,\n \"etag_id\": \"6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b\"\n }\n },\n {\n \"id\": \"132f9613-8725-e6f1-2cb5-3cd12e8da1fe\",\n \"type\": \"string\",\n \"links\": {\n \"self\": \"https://ivyjjimZXTFEFzHy.foVwzTWF+y8\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"data_size\": 6,\n \"resource_version\": 4,\n \"etag_id\": \"6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b\"\n },\n \"key_0\": \"string\"\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 8761,\n \"total_method\": \"exact\"\n },\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": null,\n \"first\": \"https://IrCwxqPjwzWIiymePvRUw.ambSzfIj5TjjIz0RPXXKfTpaIvdD+qisp\",\n \"last\": \"https://rBtzZoaMDijcxpUQrbjnvOmWFcqrGt.acfnpLBljxEU,R7DnnyK9L3YqKOVMXi4RMeNRxdfnhllbm89eDirt0wJKup\",\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7292384d-133a-46cb-9e23-9c69b0cc1ad6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e0e01f5-c90e-4f18-adb0-56943a084dcd", "name": "Forbidden. You do not have permission to access this resource.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"You do not have permission to access this resource.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc026c6e-0b1d-46fa-aed3-e62f1d3d37e5", "name": "Unprocessable Content. The server couldn't satisfy your request, most likely due to a timeout.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Content\",\n \"status\": \"422\",\n \"detail\": \"request timed out after 20000 ms.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07ab7484-53a7-4d2a-97a1-83257f9eb9ad", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The method used to calculate the total number of matching entries in the response.\n (This can only be one of lower_bound,observed)", "type": "text/plain" }, "key": "page[total_method]", "value": "lower_bound" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(name,\"My Wishlist\")" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Entries will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting).\n (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at,null)", "type": "text/plain" }, "key": "sort", "value": "id" }, { "disabled": false, "description": { "content": "Specifies how long in milliseconds the request should be allowed to take. The service will return a 422 if the request takes longer than the specified timeout.\n", "type": "text/plain" }, "key": "timeout", "value": "8698" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dc5b1781-e9d6-4c98-9ada-22b139dc820d", "name": "Get a Custom API Entry", "request": { "name": "Get a Custom API Entry", "description": { "content": "Get a Custom API Entry", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b3c3c291-4d89-49f3-b7a3-d1cb985aa709", "name": "A Custom API Entry", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "A unique identifier representing the current version of the resource. When the resource changes, the ETag value will also change. The ETag hash will be the same value as `etag_id`, and is marked as a weak entity tag string. For example: etag: W/\"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\", etag_id: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\n", "type": "text/plain" }, "key": "ETag", "value": "string" } ], "body": "{\n \"data\": {\n \"id\": \"7e067539-6f6c-46e1-8c55-940031b36c6a\",\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ],\n \"links\": {\n \"self\": \"/v2/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"resource_version\\\"\": 0,\n \"data_size\\\"\": 6,\n \"etag_id\\\"\": \"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec9813af-d49c-43c3-b931-2c6dea99e4f4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "237b1b6c-c940-4bd5-9a92-9a5164ac52a5", "name": "Forbidden. You do not have permission to access this resource.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"You do not have permission to access this resource.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f283f09-9cc2-4d78-af22-eaa20ba2caaa", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88afdba5-1163-45dc-a02a-96f48d087a72", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4b1e67bc-1751-449d-b14b-139a454764c2", "name": "Update a Custom API Entry", "request": { "name": "Update a Custom API Entry", "description": { "content": "Update a Custom API Entry", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "cb2ff651-4a0b-4e12-873d-7bca53583212", "name": "A Custom API Entry", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "A unique identifier representing the current version of the resource. When the resource changes, the ETag value will also change. The ETag hash will be the same value as `etag_id`, and is marked as a weak entity tag string. For example: etag: W/\"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\", etag_id: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\n", "type": "text/plain" }, "key": "ETag", "value": "string" } ], "body": "{\n \"data\": {\n \"id\": \"7e067539-6f6c-46e1-8c55-940031b36c6a\",\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ],\n \"links\": {\n \"self\": \"/v2/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"resource_version\\\"\": 0,\n \"data_size\\\"\": 6,\n \"etag_id\\\"\": \"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26ae6055-39f5-4423-8bfd-13d9ae90acaa", "name": "A Custom API Entry", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "A unique identifier representing the current version of the resource. When the resource changes, the ETag value will also change. The ETag hash will be the same value as `etag_id`, and is marked as a weak entity tag string. For example: etag: W/\"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\", etag_id: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\n", "type": "text/plain" }, "key": "ETag", "value": "string" } ], "body": "{\n \"data\": {\n \"id\": \"7e067539-6f6c-46e1-8c55-940031b36c6a\",\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 0,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\"\n ],\n \"links\": {\n \"self\": \"/v2/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n },\n \"resource_version\\\"\": 0,\n \"data_size\\\"\": 6,\n \"etag_id\\\"\": \"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed6b662f-0c04-448f-bd8c-44a547c8418c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5087be6-f054-43a3-b80e-d1f6573556e2", "name": "Forbidden. You do not have permission to access this resource.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"You do not have permission to access this resource.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a6532af-05e0-4206-9fce-480f5e20a116", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6937aed-6e5f-4574-a918-87d20a44cfb6", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01b87ad0-dc96-48e7-8d0f-6dc5ac617e0a", "name": "Precondition Failed.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Precondition Failed", "code": 412, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Precondition Failed\",\n \"status\": \"412\",\n \"detail\": \"The provided ETag 'W/\\\"4b227777d4dd1fc61c6f884f48641d02b4d121d3fd328cb08b5531fcacdabf8a\\\"', does not match the current ETag 'W/\\\"ef2d127de37b942baad06145e54b0c619a1f22327b2ebbcfbec78f5564afe39d\\\"'.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e263c39-eb70-4d57-ad43-b3b525ae41f5", "name": "Payload Too Large.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Request Entity Too Large\",\n \"status\": \"413\",\n \"detail\": \"Maximum entry size reached.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76121ab6-7242-45a7-9503-7458b5ec17f9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca1082cb-720c-4370-8dda-3ea6b1e78854", "name": "The service is temporarily unavailable. This request can be safely retried.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"wishlist_ext\",\n \"name\": \"My Wishlist\",\n \"items_count\": 1,\n \"keep_purchased\": false,\n \"tags\": [\n \"birthday\",\n \"gifts\",\n \"priority\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"An unknown error occurred\",\n \"status\": \"503\",\n \"title\": \"Service Unavailable\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bb2e882b-c4d9-4be6-acff-a7e62ce7d5b6", "name": "Delete a Custom API Entry", "request": { "name": "Delete a Custom API Entry", "description": { "content": "Delete a Custom API Entry", "type": "text/plain" }, "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" } }, { "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id", "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "13f2cf73-f2fc-453a-9a13-61b88551dd83", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6e2c1589-87c7-4928-9dd4-d0e53bab11e1", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d57554f9-2851-421e-b205-0c00e78a41e1", "name": "Forbidden. You do not have permission to access this resource.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"You do not have permission to access this resource.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed8ba63f-d07e-4137-b40d-797b799a6413", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "735e09c7-4bca-4fb8-883f-a6ebeb88646f", "name": "Precondition Failed.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Precondition Failed", "code": 412, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Precondition Failed\",\n \"status\": \"412\",\n \"detail\": \"The provided ETag 'W/\\\"4b227777d4dd1fc61c6f884f48641d02b4d121d3fd328cb08b5531fcacdabf8a\\\"', does not match the current ETag 'W/\\\"ef2d127de37b942baad06145e54b0c619a1f22327b2ebbcfbec78f5564afe39d\\\"'.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1fa4d82a-81fe-482c-a026-1bc1948c8eab", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "185b6a7e-9873-401e-847c-c14715ea6590", "name": "The service is temporarily unavailable. This request can be safely retried.", "originalRequest": { "url": { "path": [ "v2", "settings", "extensions", "custom-apis", ":custom-api-id", "entries", ":custom-api-entry-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-id" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the Custom API Entry.", "type": "text/plain" }, "type": "any", "value": "7e067539-6f6c-46e1-8c55-940031b36c6a", "key": "custom-api-entry-id" } ] }, "header": [ { "disabled": false, "description": { "content": "(Required) When If-Match is set, the value must be W/\"{etag_id}\". If the value of the header matches, the request completes. If not, HTTP 412 Precondition Failed is returned.\n", "type": "text/plain" }, "key": "If-Match", "value": "string" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"An unknown error occurred\",\n \"status\": \"503\",\n \"title\": \"Service Unavailable\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Personal Data Logs", "description": "When a user’s personal data is changed, an event is logged by Commerce. You can use the Personal Data Logs endpoint to access these logs.\n\nThis API is read only, and you cannot add, update, or delete logs using this API.\n\nThe API only allows you to read all logs for a particular data entry (specified in the filter GET parameter).\n\n:::note\nCurrently, personal data management is only enabled for a limited set of endpoints. See the [personal data concepts page](/docs/api/personal-data/personal-data-introduction) for the list of endpoints that support personal data management.\n:::\n", "item": [ { "id": "2d81ecd7-2695-45a6-b730-527fa467a2a3", "name": "Get Personal Data Logs", "request": { "name": "Get Personal Data Logs", "description": { "content": "Gets a list of logs for a specific resource id and resource type.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n:::note\n* This request is only accessible to `client_credentials` token users with `Seller Admin`, `Support` and `IT` roles.\n* Non `client_credentials` token users cannot access this endpoint. See [Permissions](/docs/authentication/tokens/permissions).\n* This request requires a filter for `resource_type` and `resource_id`.\n :::\n\n## Filtering\n\nThe following operator and attributes are **required** for [filtering](/guides/Getting-Started/filtering) erasure requests.\n\n| Operator | Description |\n|:---------|:-----------------------------------------------------------------------------------------------------|\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n\n| Attribute | Type | Operator | Example |\n| :---------------- | :--- | :--- | :-------------------------------------------------------- |\n| `resource_type` | `string` | `eq` | `eq(resource_type,customer)` |\n| `resource_id` | `string` | `eq` | `eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "personal-data", "logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e2021905-26ad-4b9d-9830-2dc5746abb3e", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "personal-data", "logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"faf8c40f-a680-40ae-b7bc-78533bbdd8c3\",\n \"store_id\": \"00000000-0000-1000-8000-000000000000\",\n \"type\": \"personal_data_log_entry\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"time\": \"2022-04-29T10:51:14.374Z\",\n \"event_type\": \"user-authentication-info.event.created\",\n \"delta\": {\n \"email\": \"some@email.com\",\n \"id\": \"00000000-0000-1000-8000-111111111112\",\n \"name\": \"some_name\",\n \"realm_id\": \"00000000-0000-1000-8000-111111111111\",\n \"store_id\": \"00000000-0000-1000-8000-000000000000\",\n \"type\": \"user-authentication-info\"\n },\n \"resource_id\": \"00000000-0000-1000-8000-111111111112\",\n \"resource_type\": \"user-authentication-info\",\n \"relationships\": {\n \"resource_path\": {\n \"url\": \"http://www.elaticpath.com\"\n }\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/personal-data/logs?page[offset]=0&page[limit]=20\",\n \"first\": \"https://useast.api.elasticpath.com/v2/personal-data/logs?page[offset]=0&page[limit]=20\",\n \"last\": \"https://useast.api.elasticpath.com/v2/personal-data/logs?page[offset]=0&page[limit]=20\",\n \"next\": \"null\",\n \"prev\": \"null\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5289bbb-9558-40f0-b75b-77367717624e", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "personal-data", "logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"bad filter: resource_id and resource_type are the filter fields that are both mandatory and only they are allowed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58c61006-2f66-46d0-bf01-6afd7a2b0c15", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "personal-data", "logs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Personal Data Related Data Entries", "description": "This is a supplementary endpoint for the [logs](/docs/api/personal-data/logs-time-to-live-settings) endpoint. It allows you to view all data entries that are related to the\nresource specified in the filter. For example, a user can get all data items that relate to a customer, such as addresses or user authentication info.\n\nThis API is read only, and you cannot add, update, or delete anything using this API.\n\nThe API only allows you to list related data items for a particular data entry (specified in the filter GET parameter).\n", "item": [ { "id": "c5b05c92-21b3-4408-a60a-9767a7949721", "name": "Get Personal Data Related Data Entries", "request": { "name": "Get Personal Data Related Data Entries", "description": { "content": "Gets a list of related data entries filtered by specific resource id and resource type.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n:::note\n\n* This request is only accessible to `client_credentials` token users with `Seller Admin`, `Support` and `IT` roles.\n* Non `client_credentials` token users cannot access this endpoint. See [Permissions](/docs/authentication/tokens/permissions).\n* This request requires a filter for `resource_type` and `resource_id`.\n\n:::\n\n## Filtering\n\nThe following operator and attributes are **required** for [filtering](/guides/Getting-Started/filtering) erasure requests.\n\n| Operator | Description |\n|:---------|:-----------------------------------------------------------------------------------------------------|\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n\n| Attribute | Type | Operator | Example |\n| :---------------- | :--- | :--- | :-------------------------------------------------------- |\n| `resource_type` | `string` | `eq` | `eq(resource_type,customer)` |\n| `resource_id` | `string` | `eq` | `eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "personal-data", "related-data-entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "95df2db1-aae2-4cd9-92a9-8d2b44a0956c", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "personal-data", "related-data-entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"resource_id\": \"00000000-0000-1000-8000-111111111112\",\n \"type\": \"related_data_entry\",\n \"resource_type\": \"user-authentication-info\"\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 20,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/personal-data/related-data-entries?page[offset]=0&page[limit]=20\",\n \"first\": \"https://useast.api.elasticpath.com/v2/personal-data/related-data-entries?page[limit]=20&page[offset]=0\",\n \"last\": \"https://useast.api.elasticpath.com/v2/personal-data/related-data-entries?page[offset]=0&page[limit]=20\",\n \"next\": \"null\",\n \"prev\": \"null\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30ee12e2-d992-472d-aa22-f121c7c3e806", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "personal-data", "related-data-entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"bad filter: resource_id and resource_type are the filter fields that are both mandatory and only they are allowed\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "675ec0fd-7d55-4e34-adca-cca49f5ac6c0", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "personal-data", "related-data-entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Personal Data Erasure Requests", "description": "Erasure requests enable you to exercise the right, referred to in regulations such as GDPR, as the right to be\nforgotten or right to erase.\nErasure requests allow you to wipe out personal data from Commerce in an automated way, including:\n\n* All related resources (for example, addresses, customers, and so on.)\n* Personal Data Logs\n\nErasure requests can be created for any data entry in the personal data set (see [Personal Data Concept](/docs/api/personal-data/personal-data-introduction) for details), and the result is the same.\n\n:::note\nCurrently, it does not include flows or data external to Commerce.\n:::\n\nErasure requests are processed asynchronously. The POST requests return immediately, and processing continues in\nthe background. You can use the GET endpoint to poll for results until you see `{...\"status\":\"SUCCESS\"...}` in the\nresponse body.\n\nIn the unlikely event an erasure request fails (if the status is not equal to `SUCCESS`), you are advised to retry\nby creating another erasure request. If the problem persists, contact Support.\n\n:::note\nCurrently, personal data management is only enabled for a limited set of endpoints. See\nthe [personal data concepts page](/docs/api/personal-data/personal-data-introduction) for the list of endpoints that support personal data\nmanagement.\n:::\n\nSeller Admin & IT users have full access to Erasure Requests, and Support users have read access.\n", "item": [ { "id": "d7709a3a-eff6-4b42-964f-29e1c4e02702", "name": "Create Personal Data Erasure Request", "request": { "name": "Create Personal Data Erasure Request", "description": { "content": "This request serves to create a new erasure request for a given resource ID and Type. All resources that belong to the same personal data set will be erased.\n", "type": "text/plain" }, "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"resource_type\": \"account\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1f961529-43bc-4de1-86cd-cec951d14e50", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"resource_type\": \"account\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"fb25ecd9-c610-4659-97d6-0a7550ac0ddc\",\n \"type\": \"erasure_request\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"resource_type\": \"account\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"status\": \"CREATED\",\n \"status_description\": \"The erasure request successfully created\",\n \"created_at\": \"2022-06-07T12:25:38.52Z\",\n \"updated_at\": \"2022-06-07T12:25:38.69Z\",\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/personal-data/erasure-requests/fb25ecd9-c610-4659-97d6-0a7550ac0ddc\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "276aaee8-28f8-4924-8fc4-776395ea7dfa", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"resource_type\": \"account\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Type' on the 'ttl-type' tag.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65c0402b-77a8-4244-bdf6-cc541dee7ad3", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"resource_type\": \"account\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"type\": \"string\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b17ddcdf-ffda-4848-b45e-9423107f5003", "name": "Get all Personal Data Erasure Request", "request": { "name": "Get all Personal Data Erasure Request", "description": { "content": "Gets a list of erasure requests for a specific resource id and resource type.\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n## Filtering\n\nThe following operator and attributes are **required** for [filtering](/guides/Getting-Started/filtering)\nerasure requests.\n\n| Operator | Description |\n|:---------|:-----------------------------------------------------------------------------------------------------|\n| `eq` | Checks whether the values of two operands are equal. If the values are equal, the condition is true. |\n\n| Attribute | Type | Operator | Example |\n|:----------------| :--- | :--- |:--------------------------------------------------------|\n| `resource_type` | `string` | `eq` | `eq(resource_type,customer)` |\n| `resource_id` | `string` | `eq` | `eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178\\)` |\n", "type": "text/plain" }, "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0ef54d65-9bd2-4b49-8ce6-1a14928ce59e", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"page\": {\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n },\n \"data\": [\n {\n \"id\": \"43eb23ef-9a97-466f-9315-d0e0c9df25b5\",\n \"type\": \"erasure_request\",\n \"resource_id\": \"abe71c87-974d-4ced-9f83-6b8d5502b0e8\",\n \"resource_type\": \"account\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"status\": \"FAILURE\",\n \"status_description\": \"There was an error processing your request, you can retry it or report it using the id\",\n \"created_at\": \"2022-05-25T10:10:58.623Z\",\n \"updated_at\": \"2022-05-25T10:10:58.676Z\"\n },\n {\n \"id\": \"eeb182ed-f929-4197-bb43-7104afa852f2\",\n \"type\": \"erasure_request\",\n \"resource_id\": \"74f98b7a-dbbf-49ed-b7a7-eaea766b8e38\",\n \"resource_type\": \"address\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"status\": \"SUCCESS\",\n \"status_description\": \"The erasure request is successfully processed\",\n \"created_at\": \"2022-05-26T08:25:37.618Z\",\n \"updated_at\": \"2022-05-26T08:25:37.698Z\"\n },\n {\n \"id\": \"39787c4b-a338-4bd7-ace9-456d1ae8e90b\",\n \"type\": \"erasure_request\",\n \"resource_id\": \"3327fb93-b687-4c0c-a850-ee95e0303ef1\",\n \"resource_type\": \"account\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"status\": \"FAILURE\",\n \"status_description\": \"There was an error processing your request, you can retry it or report it using the id\",\n \"created_at\": \"2022-05-26T08:48:56.183Z\",\n \"updated_at\": \"2022-05-26T08:48:56.365Z\"\n }\n ],\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/personal-data/erasure-requests?filter=eq(resource_type,account_member):eq(resource_id,00000000-0000-1000-8000-000f00000300)&page[offset]=0&page[limit]=10\",\n \"first\": \"https://useast.api.elasticpath.com/v2/personal-data/erasure-requests?filter=eq(resource_type,account_member):eq(resource_id,00000000-0000-1000-8000-000f00000300)&page[offset]=0&page[limit]=10\",\n \"last\": \"https://useast.api.elasticpath.com/v2/personal-data/erasure-requests?filter=eq(resource_type,account_member):eq(resource_id,00000000-0000-1000-8000-000f00000300)&page[offset]=0&page[limit]=10\",\n \"next\": \"null\",\n \"prev\": \"null\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21118428-5981-406a-8ad3-2062014c9d0a", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1cca224f-cabc-4984-bb8c-de85ff5d36c3", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "eq(resource_id,0f850c15-d643-480a-a2b4-9e3c26067178)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "62d3081d-995d-4faf-bfa9-da1300953d91", "name": "Get Personal Data Erasure Request", "request": { "name": "Get Personal Data Erasure Request", "description": { "content": "This request serves to get an existing erasure request by its ID.\n", "type": "text/plain" }, "url": { "path": [ "v2", "personal-data", "erasure-requests", ":erasure_request_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "erasure_request_id", "disabled": false, "description": { "content": "(Required) The id of the Personal-Data Erasure Request.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2c5d34b6-89ae-4f23-bc8b-e7787695acc1", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests", ":erasure_request_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Personal-Data Erasure Request.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "erasure_request_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"fb25ecd9-c610-4659-97d6-0a7550ac0ddc\",\n \"type\": \"erasure_request\",\n \"resource_id\": \"98140362-6caf-4829-b93d-953ac6adbe6e\",\n \"resource_type\": \"account\",\n \"initiator\": {\n \"access-token-email\": \"accounts@molt.in\",\n \"access-token-id\": \"1222341536243515939\",\n \"access-token-name\": \"moltin test team\",\n \"access-token-store-id\": \"15ea9633-278c-4807-80f7-2009fed63c7e\",\n \"access-token-type\": \"client-credentials-token\"\n },\n \"status\": \"CREATED\",\n \"status_description\": \"The erasure request successfully created\",\n \"created_at\": \"2022-06-07T12:25:38.52Z\",\n \"updated_at\": \"2022-06-07T12:25:38.69Z\",\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/personal-data/erasure-requests/fb25ecd9-c610-4659-97d6-0a7550ac0ddc\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7e46dd4-513b-48f7-8861-f0a5764406e4", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests", ":erasure_request_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Personal-Data Erasure Request.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "erasure_request_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"not found\",\n \"status\": \"404\",\n \"title\": \"Not Found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d23ea6cc-e35f-45d3-bbe1-9d7874996a6e", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "personal-data", "erasure-requests", ":erasure_request_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The id of the Personal-Data Erasure Request.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "erasure_request_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Logs Time to Live Settings", "description": "You can use the Logs TTL Settings endpoint to retrieve and update settings controlling logs time-to-live (TTL).\n", "item": [ { "id": "4be3694f-488c-40ec-a3c8-a1106c6bfd6e", "name": "Get Logs Time-to-Live (TTL) Settings", "request": { "name": "Get Logs Time-to-Live (TTL) Settings", "description": {}, "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "73c2d30c-591b-476f-92e6-e3fb07782550", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd8dc5ec-d559-4a08-a9ea-3e88be7b69c5", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0e47d87-e1f4-43e5-9fd1-d8b1bab1e7ae", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2e10bb7e-95fd-481e-9f38-6f9810918f34", "name": "Update Logs Time-to-Live (TTL) Settings", "request": { "name": "Update Logs Time-to-Live (TTL) Settings", "description": {}, "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"time_to_live\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d77e7a0f-591a-4da5-ab34-07557edde0cd", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"time_to_live\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e96f5ba0-3fb2-4f87-a537-df7f8e8cbbd7", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"time_to_live\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Type' on the 'ttl-type' tag.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "325ed80f-a593-4ddb-a924-706a22bf9d93", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings", "logs-ttl" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"days\": 10,\n \"type\": \"time_to_live\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Jobs", "description": "\nJobs have the following characteristics:\n\n - Jobs are asynchronous.\n - This process is repeated until all jobs are processed.\n - Jobs have a different status, depending on where a job is in its lifecycle.\n - Jobs are processed one at a time. You can continue to send requests using endpoints that function as jobs, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date.\n - Jobs include the data used when an endpoint is run.\n - Jobs report messages and/or errors to help you understand the reasons for any failed jobs.\n \n### Job Lifecycle\n \nA job can have the following status:\n\n- PENDING - Commerce has received the request but is currently busy processing other requests.\n- STARTED - Commerce has started processing the job.\n- SUCCESS - The job has successfully completed.\n- FAILED - The job has failed.\n", "item": [ { "id": "d845fb4e-56f8-4bc1-b91a-f38b267baab9", "name": "Get All Jobs", "request": { "name": "Get All Jobs", "description": { "content": "You can use this endpoint to display the status of your jobs.", "type": "text/plain" }, "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cb5696ad-67e7-465f-bc37-cdd30a2cc73a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"974c9db4-38da-4dbf-90c2-33eed5f3e77c\",\n \"type\": \"job\",\n \"job_type\": \"order_export\",\n \"status\": \"failed\",\n \"error\": \"No results matched the supplied filter\",\n \"link\": {\n \"href\": \"\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/jobs/974c9db4-38da-4dbf-90c2-33eed5f3e77c\"\n },\n \"timestamps\": {\n \"created_at\": \"2018-10-04T11:08:49.156490335Z\",\n \"updated_at\": \"2018-10-04T11:08:49.162867081Z\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f668308-e255-4196-8b60-34120828a93a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "769ea035-bc27-4434-8b9f-47626c8658f8", "name": "Create Job", "request": { "name": "Create Job", "description": { "content": "Create a Job to export orders to a CSV file. Jobs automatically expire one week after creation. You must fetch the exported data before the jobs expire.", "type": "text/plain" }, "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"gt(created_at,2018-09-01):lt(created_at,2018-10-01):eq(payment,refunded)\",\n \"job_type\": \"order_export\",\n \"type\": \"job\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "20ffd948-f128-4d63-89f6-a7ca758d77e2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"gt(created_at,2018-09-01):lt(created_at,2018-10-01):eq(payment,refunded)\",\n \"job_type\": \"order_export\",\n \"type\": \"job\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"974c9db4-38da-4dbf-90c2-33eed5f3e77c\",\n \"type\": \"job\",\n \"job_type\": \"order_export\",\n \"status\": \"failed\",\n \"error\": \"No results matched the supplied filter\",\n \"link\": {\n \"href\": \"\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/jobs/974c9db4-38da-4dbf-90c2-33eed5f3e77c\"\n },\n \"timestamps\": {\n \"created_at\": \"2018-10-04T11:08:49.156490335Z\",\n \"updated_at\": \"2018-10-04T11:08:49.162867081Z\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9680e8be-297e-4e22-8f21-6197a5f2a35b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"gt(created_at,2018-09-01):lt(created_at,2018-10-01):eq(payment,refunded)\",\n \"job_type\": \"order_export\",\n \"type\": \"job\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "08e01210-a2b8-4cec-96de-dd43210a7e0f", "name": "Get a Job", "request": { "name": "Get a Job", "description": { "content": "Retrieves the specified job.", "type": "text/plain" }, "url": { "path": [ "v2", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "jobID", "disabled": false, "description": { "content": "(Required) The unique identifier of the requested job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f728cd87-72f2-4d94-adb8-10c57cefc8e6", "name": "default", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the requested job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"974c9db4-38da-4dbf-90c2-33eed5f3e77c\",\n \"type\": \"job\",\n \"job_type\": \"order_export\",\n \"status\": \"failed\",\n \"error\": \"No results matched the supplied filter\",\n \"link\": {\n \"href\": \"\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/jobs/974c9db4-38da-4dbf-90c2-33eed5f3e77c\"\n },\n \"timestamps\": {\n \"created_at\": \"2018-10-04T11:08:49.156490335Z\",\n \"updated_at\": \"2018-10-04T11:08:49.162867081Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "383d00e4-24f7-430d-bd4d-d9c5a5633a91", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the requested job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"title\": \"Resource Not Found\",\n \"status\": 404,\n \"detail\": \"The resource you are requesting does not exist\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68750b09-7847-4f95-8bfc-80537b69b3b6", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the requested job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8b00df76-7e7e-4869-a37c-5d97c5f356b7", "name": "Get a Job File", "request": { "name": "Get a Job File", "description": { "content": "Retrieves a link to the CSV file that contains your exported order.", "type": "text/plain" }, "url": { "path": [ "v2", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "jobID", "disabled": false, "description": { "content": "(Required) The unique identifier of the job whose CSC file you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e1477c8c-00fc-470c-b1ce-a37f448cb86b", "name": "200", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job whose CSC file you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"href\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "726f9a83-e939-4e07-ae1e-5a2081c0105f", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job whose CSC file you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"title\": \"Resource Not Found\",\n \"status\": 404,\n \"detail\": \"The resource you are requesting does not exist\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55a2d573-d10b-402c-8afc-4c9ddbe6dd92", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job whose CSC file you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Files", "description": "You can upload image files or URLs by using `multipart/form-data` as the content type header. For example, `\"Content-Type: multipart/form-data\" \\`. Commerce supports the following file types.\n\n| File Extension | Description |\n| --- | --- |\n| .gif | Graphics Interchange Format (GIF) |\n| .jpg/jpeg | Joint Photographic Experts Group (JPEG) format |\n| .png | Portable graphics format |\n| .webp | Web picture format |\n| .mp4 | Moving Picture Experts Group (MPEG) format |\n| .mov | QuickTime Movie format |\n| .pdf | Portable Document Format |\n| .usdz | Universal Scene Description Format |\n| .glb | Global File format |\n| .jp2 | Compressed bitmap image saved in Joint Photographic Experts Group (JPEG) format |\n| .jxr | Extended range for Joint Photographic Experts Group (JPEG) format |\n| .aac | Advanced Audio Coding (AAC) format |\n| .vrml | Virtual Reality Modelling Language (VRML) format |\n| .doc(x) | Microsoft Word Open XML format |\n| .ppt(x) | Microsoft PowerPoint Open XML format |\n| .xls(x) | Microsoft Excel Open XML format |\n\nBy default, the maximum file size is 8MB. If you need to support larger file sizes, contact your Elastic Path representative. Alternatively, store files somewhere else and reference them.\n", "item": [ { "id": "2db4b017-0ed6-4e79-bbbb-dc4cb53e020c", "name": "Get all Files", "request": { "name": "Get all Files", "description": { "content": "Retrieves all files.\n\n### Filtering\n\nFor general filtering syntax, see [Filtering](/guides/Getting-Started/filtering).\n\nThe following operators and attributes are available when filtering on this endpoint.\n\n| Attribute | Type | Operators | Example |\n|:----------------------|:----------|:--------------------------|:-------------|\n| `id` | `string` | `in` | `in(id,file-id-1,file-id-2,file-id-3)` |\n| `file_name` | `string` | `eq` / `like` | `eq(file_name, my_image.jpg)` |\n| `width` | `integer` | `gt` / `ge` / `lt` / `le` | `gt(width,200)` |\n| `height` | `integer` | `gt` / `ge` / `lt` / `le` | `lt(height,500)` |\n| `file_size` | `integer` | `gt` / `ge` / `lt` / `le` | `le(file_size,20953)` |\n\n#### Bulk File Retrieval\n\nTo retrieve multiple files by their IDs in a single request, use the `in` operator with a comma-separated list of file IDs:\n\n```\nGET /v2/files?filter=in(id,06b881bd-f152-4c36-8658-7132a8fab49c,ec73567b-04e8-4000-a11a-7e1407cc2f21)\n```\n\nThis is more efficient than making separate requests for each file and is recommended for bulk operations.\n\n**Note on invalid IDs**: If any IDs in the filter are missing, malformed, or do not exist in the store, they will be silently ignored. The response will only include files that were successfully found. For example, if you request 5 IDs but only 3 exist, the response will contain 3 files with `total: 3` in the metadata.\n", "type": "text/plain" }, "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nFiltering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(file_name,00000000-0000-0000-0000-000000000000.png)" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0a45e259-1647-4fd6-9a8b-70de140db055", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nFiltering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(file_name,00000000-0000-0000-0000-000000000000.png)" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"f8cf26b3-6d38-4275-937a-624a83994702\",\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\"\n },\n \"file_name\": \"f6669358-85db-4367-9cde-1deb77acb5f4.png\",\n \"mime_type\": \"image/png\",\n \"file_size\": 110041,\n \"meta\": {\n \"dimensions\": {\n \"width\": 1000,\n \"height\": 1000\n },\n \"timestamps\": {\n \"created_at\": \"2018-03-13T13:45:21.673Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/f8cf26b3-6d38-4275-937a-624a83994702\"\n }\n }\n ],\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files?page[offset]=0&page[limit]=100&filter=\",\n \"first\": \"https://useast.api.elasticpath.com/v2/files?page[offset]=0&page[limit]=100&filter=\",\n \"last\": null\n },\n \"meta\": {\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5e86c72-41c5-4dbd-8abd-be0cd7794aa5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "\nFiltering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(file_name,00000000-0000-0000-0000-000000000000.png)" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "28941af5-6f9c-4656-91c8-1e259a6911d7", "name": "Create a File", "request": { "name": "Create a File", "description": { "content": "Create a File", "type": "text/plain" }, "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "Indicates the file you want to upload.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.", "type": "text/plain" }, "key": "file_location", "value": "@/path/to/file.jpg", "type": "text" } ] }, "auth": null }, "response": [ { "id": "81c8dd78-86de-41f1-a7e0-a8c062484e6d", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "Indicates the file you want to upload.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.", "type": "text/plain" }, "key": "file_location", "value": "@/path/to/file.jpg", "type": "text" } ] } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"f8cf26b3-6d38-4275-937a-624a83994702\",\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\"\n },\n \"file_name\": \"f6669358-85db-4367-9cde-1deb77acb5f4.png\",\n \"mime_type\": \"image/png\",\n \"file_size\": 110041,\n \"meta\": {\n \"dimensions\": {\n \"width\": 1000,\n \"height\": 1000\n },\n \"timestamps\": {\n \"created_at\": \"2018-03-13T13:45:21.673Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/f8cf26b3-6d38-4275-937a-624a83994702\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c808097-ffe4-4425-a2fd-178d1dbde866", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "Indicates the file you want to upload.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.", "type": "text/plain" }, "key": "file_location", "value": "@/path/to/file.jpg", "type": "text" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"file_location invalid\",\n \"status\": 422,\n \"detail\": \"@/path/to/file.jpg is not a valid URL\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c70dea0-9ca7-48fb-bf17-ab2c1f52ba1a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "Indicates the file you want to upload.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.", "type": "text/plain" }, "key": "file_location", "value": "@/path/to/file.jpg", "type": "text" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"file_location invalid\",\n \"status\": 422,\n \"detail\": \"@/path/to/file.jpg is not a valid URL\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "403dedaa-d51f-4f3a-af1a-e4e13426a227", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "Indicates the file you want to upload.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.", "type": "text/plain" }, "key": "file_location", "value": "@/path/to/file.jpg", "type": "text" } ] } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5a8edb94-b7de-438c-8732-c0ed0948fc62", "name": "Get a File", "request": { "name": "Get a File", "description": { "content": "Get a File", "type": "text/plain" }, "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "fileID", "disabled": false, "description": { "content": "(Required) The unique identifier for a file.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f634ad9d-9beb-40fc-b97a-596f352e1535", "name": "default", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for a file.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"f8cf26b3-6d38-4275-937a-624a83994702\",\n \"link\": {\n \"href\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/f8cf26b3-6d38-4275-937a-624a83994702.png\"\n },\n \"file_name\": \"f6669358-85db-4367-9cde-1deb77acb5f4.png\",\n \"mime_type\": \"image/png\",\n \"file_size\": 110041,\n \"meta\": {\n \"dimensions\": {\n \"width\": 1000,\n \"height\": 1000\n },\n \"timestamps\": {\n \"created_at\": \"2018-03-13T13:45:21.673Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/files/f8cf26b3-6d38-4275-937a-624a83994702\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f5d6ad5-5d76-4033-91c7-49cd56f92c6d", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for a file.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Resource Not Found\",\n \"status\": 404,\n \"detail\": \"The resource you are requesting does not exist\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ab2b1f0-b313-45cf-b0b0-84de2d841673", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for a file.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3f4c7463-3644-4332-8f99-40b05bda4f38", "name": "Delete a File", "request": { "name": "Delete a File", "description": { "content": "Delete a File", "type": "text/plain" }, "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "fileID", "disabled": false, "description": { "content": "(Required) The unique identifier of the file you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "19d21510-b8f5-443c-a790-87248061848d", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the file you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f3720810-2a92-47de-8e93-cf1d96739dd1", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the file you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": 403,\n \"detail\": \"You are trying to remove a file outside of the tenancy\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f4f05aa-7ee5-41c0-9f70-a71c0c78fc45", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the file you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Resource Not Found\",\n \"status\": 404,\n \"detail\": \"The resource you are requesting does not exist\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6847abdd-cb40-4bb3-9c75-ed486f675cac", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "files", ":fileID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the file you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "fileID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Flows", "description": "\n### Flows in Commerce\n\nThere are two scenarios for using flows:\n\n- Extend an existing resource, such as customers and orders.\n- Create a new resource, such as a blog, wishlist, or customer review.\n\n#### Extend an existing resource\n\nThe most common usage of the Flows API is to extend existing resources, such as `customers` and `orders`. These types of resources are called core flows and are handled differently than non-core flows. See [**Core and non-core flows**](#core-and-non-core-flows).\n\nFor example, you can extend the `customer` resource to store custom data, such as a `user_profile` field for customers. Or you might want to add an `age` field to store a customer's age.\n\nExtending a resource applies only to core flows. When creating a new flow, make sure the `slug` matches that of a core resource listed in the following table.\n\n| Flow slug | Description | Availability Level |\n|:--------------------------------------------|:-------------------------------| :---|\n| `accounts` | Extend the [`account`](/docs/api/accounts/account-management-introduction) object. | Store |\n| `account-members` | Extend the [`account-members`](/docs/api/accounts/account-members) object. | Store |\n| `account-memberships` | Extend the [`account-membership`](/docs/api/accounts/account-membership) object. | Store |\n| `addresses` | Extend the [`address`](/docs/api/addresses/account-addresses) object. | Store |\n| `authentication-realms` | Extend the [`authentication-realms`](/docs/api/single-sign-on/authentication-realms) object. | Store |\n| `carts` | Extend the [`carts`](/docs/api/carts/carts-checkout-orders-introduction) object. | Organization/Store |\n| `cart_items` | Extend the [`cart_item`](/docs/api/carts/cart-items) object. | Organization/Store |\n| `customers` | Extend the [`customer`](/docs/customer-management/customer-management-api/customer-management-api-overview) object. **Note**: Please use Account Management for all new frontend experiences. | n/a |\n| `oidc-profiles` | Extend the [`oidc-profiles`](/docs/api/single-sign-on/oidc-profiles) object. | Store |\n| `order_items` | Extend the [`order_item`](/docs/api/carts/get-order-items) object. | Organization/Store |\n| `orders` | Extend the [`order`](/docs/api/carts/orders) object. | Organization/Store |\n| `password-profiles` | Extend the [`password-profiles`](/docs/api/single-sign-on/password-profiles) object. | Store |\n| `products` | Extend the [`product`](/docs/api/pxm/products/products) object. | Store |\n| `promotions` | Extend the [`promotion`](/docs/api/promotions/promotions-standard-introduction) object. | Store |\n| `rule-promotions` | Extend the [`rule-promotion`](/docs/api/promotions-builder/create-rule-promotion) object. | Store |\n| `user-authentication-info` | Extend the [`user-authentication-info`](/docs/api/single-sign-on/user-authentication-infos) object. | Store |\n| `user-authentication-oidc-profile-info` | Extend the [`user-authentication-oidc-profile-info`](/docs/api/single-sign-on/user-authentication-oidc-profile-infos) object. | Store |\n| `user-authentication-password-profile-info` | Extend the [`user-authentication-password-profile-info`](/docs/api/single-sign-on/user-authentication-password-profile-infos) object. | Store |\n| `catalogs` | Extend the [`catalog`](/docs/api/pxm/catalog/catalogs) object. It will not extend the [`catalog-release`](/docs/api/pxm/catalog/releases) object. | Store |\n\n#### Create a new resource\n\nYou can create new resources to support product reviews, wish lists, blog articles, staff profile pages, and many more. These non-core flows are referred to as custom flows. See [**Core and non-core flows**](#core-and-non-core-flows).\n\n:::note\n\n[Custom APIs](/docs/api/commerce-extensions/custom-ap-is#custom-apis-vs-non-core-flows) are the next generation of Non-Core Flows. Flows are not going anywhere, but Custom APIs offer enhanced capabilities. We recommend using Custom APIs for any of your new use cases.\n\n:::\n\n#### Core and non-core flows\n\nThe following table describes the differences between core and non-core flows:\n\n| Core Flows | Non-core Flows |\n|:--------------------------------------------------------------|:-------------|\n| Extend an existing resource. | Create a new resource. |\n| Entries managed automatically by Commerce. | Create and manage entries manually. |\n| Requests are sent to the `fields` endpoint. | Requests are sent to the `entries` endpoint. |\n\n:::caution\n\nYou cannot delete core flows after creating them with the API or Commerce Manager.\n\n:::\n\n#### Flows taxonomy\n\nFields and entries are an integral part of flows. A flow describes a collection of fields. A field represents a single field of data. An entry is a specific instance of a flow, and is associated with a specific instance of an entity, such as a single customer. Entries for core flows (existing resources) are managed automatically for you.\n\nIn database terms, you can think of flows as tables, fields as columns, and entries as database records.\n\n### Templates in Product Experience Manager\n\nTemplates allow you to attach a specific set of attributes to your products.\n\n- You can use templates to define characteristics of your products.\n- You can use templates for Search Engine Optimization (SEO).\n\n#### Template Taxonomy\n\nAttributes and entries are integral to templates. A template describes a collection of attributes. An attribute represents a single characteristic, like color. An entry is a specific instance of an attribute, for example, blue, and is associated with a specific product.\n\n A template is exactly the same as a flow except it has a different naming convention. The name of a template is in the format **products(*slug*)** where *slug* is the slug of a template.\n\n#### Associating templates with products\n\n Once you have created your template, and [**associated**](/docs/api/flows/create-an-entry-relationship) the temp with a product in Product Experience Manager, it becomes a template. \n\n For example, if you create a template with a slug of `SizeGuide` then the template name is **products(SizeGuide)**. You can then [**associate**](/docs/api/flows/create-an-entry-relationship) this template to all clothing products in your store and the slug is included in all the responses that contain products.\n\n You can create product templates for both organization and store. In addition, stores can use organization templates for store-level products.\n\n For more information about adding attributes, see [**Fields**](/docs/api/flows/fields).\n", "item": [ { "id": "766b2692-3223-4d02-bba3-c780e5a9c766", "name": "Get all Flows", "request": { "name": "Get all Flows", "description": { "content": "- For Commerce, this endpoint retrieves a list of flows.\n- For Product Experience Manager, this endpoint retrieves a list of templates.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c868ee52-8efc-42b4-901b-5a0cb8c9fadd", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"6d320b42-237d-4474-8452-d49f884d4ae1\",\n \"type\": \"flow\",\n \"name\": \"Products-1\",\n \"slug\": \"products-1\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/6d320b42-237d-4474-8452-d49f884d4ae1\"\n },\n \"relationships\": {},\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T18:04:26.623Z\",\n \"updated_at\": \"2018-05-10T18:04:26.623Z\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5164d983-65f7-45e5-b722-a44378dfcf86", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5949fbe3-c22d-4de4-8f92-8940103ea212", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d240318d-b02a-400c-ab54-764800a63174", "name": "Create a Flow", "request": { "name": "Create a Flow", "description": { "content": "- For Commerce, this endpoint creates a flow.\n- For Product Experience Manager, this endpoint creates a template.\n\n:::caution\n\nCustom names and values prefixed with $ are not supported.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "75753232-51cf-4ec3-b39a-3617c3392bf1", "name": "default", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"6d320b42-237d-4474-8452-d49f884d4ae1\",\n \"type\": \"flow\",\n \"name\": \"Products-1\",\n \"slug\": \"products-1\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/6d320b42-237d-4474-8452-d49f884d4ae1\"\n },\n \"relationships\": {},\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T18:04:26.623Z\",\n \"updated_at\": \"2018-05-10T18:04:26.623Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e66a23f-1520-4ffd-88c7-3455453d816f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d38f380-a4c7-40f1-a2c2-dc981931a8dc", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b5ec535-98e8-4d70-a762-84afc4c8f0fe", "name": "Get a Flow", "request": { "name": "Get a Flow", "description": { "content": "- For Commerce, this endpoint retrieves a flow.\n- For Product Experience Manager, this endpoint retrieves a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID", "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "bad971b3-4069-4a24-90bd-b728966397f1", "name": "default", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"38ba1451-efa4-4361-9ca6-3fb646490f37\",\n \"type\": \"flow\",\n \"name\": \"extraFieldRenamed\",\n \"slug\": \"products\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/38ba1451-efa4-4361-9ca6-3fb646490f37\"\n },\n \"relationships\": {},\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T01:41:36.009Z\",\n \"updated_at\": \"2018-05-10T15:27:26.241Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94adb112-2aab-4cbe-bd1a-cb759edd1064", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac3d7875-9c24-4d15-83b6-a51ab3c2d5cc", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df98c378-56ea-4b48-94e3-bd7e0da57eed", "name": "Delete a Flow", "request": { "name": "Delete a Flow", "description": { "content": "- For Commerce, this endpoint deletes a flow. We recommend that you remove all the fields assigned to a flow before deleting a flow.\n- For Product Experience Manager, this endpoint deletes a template. We recommend that you remove all the attributes assigned to a template before deleting a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID", "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "63b6602c-b5eb-4264-bd6d-7d1f30c6f183", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to delete.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cc85fa36-afeb-4fdf-ae6a-f25eafb1a285", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to delete.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "214f6a89-b991-4671-a08b-b13c1ee8107c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to delete.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1fb55be5-4bf8-4fd5-b4eb-57f4fb7dc864", "name": "Update a Flow", "request": { "name": "Update a Flow", "description": { "content": "- For Commerce, this endpoint updates a flow. \n- For Product Experience Manager, this endpoint updates a template. \n\n Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the flow/template is not updated.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID", "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to update.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"25617d3e-14a6-434c-bfab-3fda87517aaf\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "155ef7df-3dd4-4883-82ce-1dcecd4bccaf", "name": "default", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to update.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"25617d3e-14a6-434c-bfab-3fda87517aaf\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"6d320b42-237d-4474-8452-d49f884d4ae1\",\n \"type\": \"flow\",\n \"name\": \"extraFieldRenamed\",\n \"slug\": \"products-1\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/6d320b42-237d-4474-8452-d49f884d4ae1\"\n },\n \"relationships\": {},\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T18:04:26.623Z\",\n \"updated_at\": \"2018-05-10T18:11:47.469Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f6d0cb0-6090-4c14-8a57-49416cc393f2", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to update.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"25617d3e-14a6-434c-bfab-3fda87517aaf\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a147792-11b3-4721-ae6f-40694df39cfb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template you want to update.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"25617d3e-14a6-434c-bfab-3fda87517aaf\",\n \"description\": \"Extends the default product object\",\n \"enabled\": true,\n \"name\": \"Products\",\n \"slug\": \"products\",\n \"type\": \"flow\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Fields", "description": "With fields, you can:\n\n- in Commerce, use a field in your flows to represent single field of data (for example a `Product Rating`) to be applied to an entity\n- in Product Experience Manager, use an attribute in your template to attach a characteristic like `color` to a product.\n\nA field/attribute represents a single piece of data. All fields/attributes have a `field_type` (`string`, `integer`, `boolean`, `date` or `relationship`), a default value, and an optional set of validation rules.\n\n:::caution\n\n- Custom names and values prefixed with `$` are not supported.\n- There is a hard limit of 100 fields per flow.\n- You can configure default values for fields. If you choose to do so, you must ensure that your default field values comply with your validation rules.\n\n:::\n\n#### Field/Attribute Validation Rules\n\nWhen creating a field/attribute, you can add validation to the values that are stored. The validation you use depends on the `field_type` of the field/attribute. Each validation rule is expressed as a validation rule object.\n\n#### `string` / `enum`\n\nMust be one of a predefined collection of strings. If you leave the field blank or enter an incorrect value then an `Invalid Value` error is displayed. \n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `array[string]` | An array of valid string values. |\n\n##### `string` / `email`\n\nMust be a valid email address.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `email` |\n\n##### `string` / `slug`\n\nCan contain only letters, numbers, hyphens and underscores.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `slug` |\n\n##### `integer` / `between`\n\nMust be between the two provided values.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `object` | An object containing `from` and `to` integers. |\n\n##### `integer` / `enum`\n\nMust be one of a predefined collection of integers.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `array[integer]` | An array of valid integer values. |\n\n##### `float` / `between`\n\nMust be between the two provided values.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `object` | An object containing `from` and `to` floats. |\n\n##### `float` / `enum`\n\nMust be one of a predefined collection of floats.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `array[float]` | An array of valid float values. |\n\n#### `date` / `enum`\n\nMust be one of a predefined collection of dates.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `enum` |\n| `options` | `array[string]` | An array of valid date values as strings \\(`YYYY-MM-DD HH:MM:SS` - time is optional\\). |\n\n##### `relationship` / `one-to-many`\n\n:::caution\nThis only applies to Commerce. You cannot use relationships in Product Experience Manager templates.\n:::\n\nAllows multiple relationships to be created.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `one-to-many` |\n| `to` | `string` | The entity type you are making relationships with in singular form (for example, `product`). |\n\n##### `relationship` / `one-to-one`\n\n:::caution\nThis only applies to Commerce. You cannot use relationships in Product Experience Manager templates.\n:::\n\nAllows only a single relationships to be created on an entry.\n\n| Attribute | Type | Description |\n| :--- | :--- | :--- |\n| `type` | `string` | `one-to-one` |\n| `to` | `string` | The entity type you are making relationships with in singular form (for example, `customer`). |\n", "item": [ { "id": "2fa30569-a517-457d-b7fa-7420e69afc70", "name": "Get all Fields", "request": { "name": "Get all Fields", "description": { "content": "- For Commerce, this endpoint retrieves all fields in a flow. \n- For Product Experience Manager, this endpoint retrieves all attributes in a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "77417c99-2b6d-4006-8ed2-c4b4e4569fac", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"e88d03d3-d46e-40d0-8302-25e6b5b1bd33\",\n \"type\": \"field\",\n \"field_type\": \"boolean\",\n \"slug\": \"on_sale\",\n \"name\": \"On Sale?\",\n \"description\": \"Is this on sale?\",\n \"required\": false,\n \"default\": null,\n \"enabled\": true,\n \"order\": null,\n \"omit_null\": false,\n \"validation_rules\": [],\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/9d69c6cf-aaee-4dc6-8908-d2bd053446a2/fields/e88d03d3-d46e-40d0-8302-25e6b5b1bd33\"\n },\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"9d69c6cf-aaee-4dc6-8908-d2bd053446a2\",\n \"type\": \"flow\"\n }\n }\n },\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-08-23T10:28:43.609Z\",\n \"updated_at\": \"2018-08-23T10:28:43.609Z\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fa52771-0442-4f81-9473-62c5b0ed426f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25cfa95b-e988-48c6-88d0-4ad65a18a906", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b8ca559-474c-4e01-800a-8fa43f4d10cf", "name": "Create a Field", "request": { "name": "Create a Field", "description": { "content": "- For Commerce, this endpoint creates a field.\n- For Product Experience Manager, this endpoint creates an attribute.\n", "type": "text/plain" }, "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 4,\n \"description\": \"Average rating as given by our users\",\n \"enabled\": true,\n \"field_type\": \"integer\",\n \"name\": \"Product Rating\",\n \"order\": 1,\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"{{flowID}}\",\n \"type\": \"flow\"\n }\n }\n },\n \"required\": false,\n \"slug\": \"product-rating\",\n \"type\": \"field\",\n \"validation_rules\": [\n {\n \"options\": {\n \"from\": 1,\n \"to\": 5\n },\n \"type\": \"between\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2fcaf572-7d6d-447f-b8ea-1599badfd801", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 4,\n \"description\": \"Average rating as given by our users\",\n \"enabled\": true,\n \"field_type\": \"integer\",\n \"name\": \"Product Rating\",\n \"order\": 1,\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"{{flowID}}\",\n \"type\": \"flow\"\n }\n }\n },\n \"required\": false,\n \"slug\": \"product-rating\",\n \"type\": \"field\",\n \"validation_rules\": [\n {\n \"options\": {\n \"from\": 1,\n \"to\": 5\n },\n \"type\": \"between\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"field\",\n \"name\": \"Product Rating\",\n \"slug\": \"product-rating\",\n \"field_type\": \"integer\",\n \"validation_rules\": [\n {\n \"type\": \"between\",\n \"options\": {\n \"from\": 1,\n \"to\": 5\n }\n }\n ],\n \"description\": \"Average rating as given by our users\",\n \"required\": false,\n \"default\": 0,\n \"enabled\": true,\n \"order\": 1,\n \"omit_null\": false,\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"type\": \"flow\",\n \"id\": \"e4145c27-aba1-46af-81a3-58f5e1cf7f15\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bea6230d-1acb-4b58-84cb-6e21ec6f3e7a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 4,\n \"description\": \"Average rating as given by our users\",\n \"enabled\": true,\n \"field_type\": \"integer\",\n \"name\": \"Product Rating\",\n \"order\": 1,\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"{{flowID}}\",\n \"type\": \"flow\"\n }\n }\n },\n \"required\": false,\n \"slug\": \"product-rating\",\n \"type\": \"field\",\n \"validation_rules\": [\n {\n \"options\": {\n \"from\": 1,\n \"to\": 5\n },\n \"type\": \"between\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc6d3b50-5075-4044-93fd-bf51f90f694b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 4,\n \"description\": \"Average rating as given by our users\",\n \"enabled\": true,\n \"field_type\": \"integer\",\n \"name\": \"Product Rating\",\n \"order\": 1,\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"{{flowID}}\",\n \"type\": \"flow\"\n }\n }\n },\n \"required\": false,\n \"slug\": \"product-rating\",\n \"type\": \"field\",\n \"validation_rules\": [\n {\n \"options\": {\n \"from\": 1,\n \"to\": 5\n },\n \"type\": \"between\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "935396b5-5d88-42fc-aeaf-0704651ba120", "name": "Get a Field", "request": { "name": "Get a Field", "description": { "content": "- For Commerce, this endpoint retrieves a field.\n- For Product Experience Manager, this endpoint retrieves an attribute.\n", "type": "text/plain" }, "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID", "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template whose field/attribute you want to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9774ca4f-9479-423e-8aad-1d05a86beeae", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template whose field/attribute you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"102b2087-d56a-45e7-bf1c-e9517716abb3\",\n \"type\": \"field\",\n \"field_type\": \"integer\",\n \"slug\": \"product-rating\",\n \"name\": \"Product Rating\",\n \"description\": \"Average rating as given by our users\",\n \"required\": false,\n \"default\": null,\n \"enabled\": true,\n \"validation_rules\": [\n {\n \"type\": \"between\",\n \"options\": {\n \"from\": 1,\n \"to\": 5\n }\n }\n ],\n \"order\": 1,\n \"omit_null\": false,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/6d320b42-237d-4474-8452-d49f884d4ae1/fields/102b2087-d56a-45e7-bf1c-e9517716abb3\"\n },\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"6d320b42-237d-4474-8452-d49f884d4ae1\",\n \"type\": \"flow\"\n }\n }\n },\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T18:19:11.559Z\",\n \"updated_at\": \"2018-05-10T18:19:11.559Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f83876b9-2aca-4dfb-996e-24bd0a882f70", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template whose field/attribute you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4450b640-6df8-4813-afdb-b122900636c9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the flow/template whose field/attribute you want to retrieve.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "55433207-f013-47fb-8bb3-0e9e8c4a913f", "name": "Update a Field", "request": { "name": "Update a Field", "description": { "content": "- For Commerce, this endpoint updates a field.\n- For Product Experience Manager, this endpoint updates an attribute.\n\nSpecify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the field/attribute is not updated.\n", "type": "text/plain" }, "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID", "disabled": false, "description": { "content": "(Required) The unique identifier for the flow/template to which the field/attribute you want to update belongs.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 1,\n \"description\": \"Average rating as given by our users\",\n \"field_type\": \"integer\",\n \"id\": \"{{flowFieldID}}\",\n \"name\": \"Product Rating\",\n \"required\": true,\n \"enabled\": true,\n \"slug\": \"product-rating\",\n \"type\": \"field\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3c9c87f5-04c2-4dae-bf0a-41b43527078e", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for the flow/template to which the field/attribute you want to update belongs.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 1,\n \"description\": \"Average rating as given by our users\",\n \"field_type\": \"integer\",\n \"id\": \"{{flowFieldID}}\",\n \"name\": \"Product Rating\",\n \"required\": true,\n \"enabled\": true,\n \"slug\": \"product-rating\",\n \"type\": \"field\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"102b2087-d56a-45e7-bf1c-e9517716abb3\",\n \"type\": \"field\",\n \"field_type\": \"integer\",\n \"slug\": \"start-of-life\",\n \"name\": \"start-of-life\",\n \"description\": \"day the iphone will work\",\n \"required\": true,\n \"default\": \"2018-01-01\",\n \"enabled\": true,\n \"validation_rules\": [\n {\n \"type\": \"between\",\n \"options\": {\n \"from\": 1,\n \"to\": 5\n }\n }\n ],\n \"order\": 1,\n \"omit_null\": false,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/6d320b42-237d-4474-8452-d49f884d4ae1/fields/102b2087-d56a-45e7-bf1c-e9517716abb3\"\n },\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"6d320b42-237d-4474-8452-d49f884d4ae1\",\n \"type\": \"flow\"\n }\n }\n },\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T18:19:11.559Z\",\n \"updated_at\": \"2018-05-10T18:36:01.208Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "659bf37c-c478-48e9-b183-c73bd0afb39e", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for the flow/template to which the field/attribute you want to update belongs.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 1,\n \"description\": \"Average rating as given by our users\",\n \"field_type\": \"integer\",\n \"id\": \"{{flowFieldID}}\",\n \"name\": \"Product Rating\",\n \"required\": true,\n \"enabled\": true,\n \"slug\": \"product-rating\",\n \"type\": \"field\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7c9f934-d0c7-4a7b-b26f-7536a5b861b4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for the flow/template to which the field/attribute you want to update belongs.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 1,\n \"description\": \"Average rating as given by our users\",\n \"field_type\": \"integer\",\n \"id\": \"{{flowFieldID}}\",\n \"name\": \"Product Rating\",\n \"required\": true,\n \"enabled\": true,\n \"slug\": \"product-rating\",\n \"type\": \"field\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8a2ec97-2062-49d0-9208-479c065280dc", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier for the flow/template to which the field/attribute you want to update belongs.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "flowFieldID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"default\": 1,\n \"description\": \"Average rating as given by our users\",\n \"field_type\": \"integer\",\n \"id\": \"{{flowFieldID}}\",\n \"name\": \"Product Rating\",\n \"required\": true,\n \"enabled\": true,\n \"slug\": \"product-rating\",\n \"type\": \"field\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3f849bb6-0336-41c3-a8cb-393eda086b83", "name": "Delete a Field", "request": { "name": "Delete a Field", "description": { "content": "- For Commerce, this endpoint deletes a field.\n- For Product Experience Manager, this endpoint deletes an attribute.\n", "type": "text/plain" }, "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowFieldID", "disabled": false, "description": { "content": "(Required) The unique identifier of the field/attribute that you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "8dd5780d-9731-4024-a56a-7e1bdc572613", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the field/attribute that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b182bfb7-4d15-4d52-b574-bd8fb9407841", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the field/attribute that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "567606b3-93d3-4061-a779-13b2690d3ebd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "fields", ":flowFieldID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the field/attribute that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "92f74539-7528-404c-9b61-71edf5176ef9", "name": "Get all Fields by Flow", "request": { "name": "Get all Fields by Flow", "description": { "content": "Get all Fields by Flow", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug of the flow the entry belongs to.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "36a4609a-1825-48e7-b495-90e60b43085a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"23d26fd2-d2e2-4c72-b4b4-3ef7a31bc47f\",\n \"type\": \"field\",\n \"field_type\": \"string\",\n \"slug\": \"background_color\",\n \"name\": \"background colors\",\n \"description\": \"background color for the product\",\n \"required\": false,\n \"default\": \"#ffffff\",\n \"enabled\": true,\n \"validation_rules\": [],\n \"order\": null,\n \"omit_null\": false,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/248c7776-bd9f-4075-8980-461b02ed3757/fields/23d26fd2-d2e2-4c72-b4b4-3ef7a31bc47f\"\n },\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"248c7776-bd9f-4075-8980-461b02ed3757\",\n \"type\": \"flow\"\n }\n }\n },\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2017-06-26T12:55:33.560Z\",\n \"updated_at\": \"2017-12-19T12:31:24.570Z\"\n }\n }\n },\n {\n \"id\": \"5f4be5bd-0c83-417a-b744-7d8c49636ab1\",\n \"type\": \"field\",\n \"field_type\": \"string\",\n \"slug\": \"background_image\",\n \"name\": \"Background Image\",\n \"description\": \"The background image for the category\",\n \"required\": false,\n \"default\": null,\n \"enabled\": true,\n \"validation_rules\": [],\n \"order\": null,\n \"omit_null\": false,\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/248c7776-bd9f-4075-8980-461b02ed3757/fields/5f4be5bd-0c83-417a-b744-7d8c49636ab1\"\n },\n \"relationships\": {\n \"flow\": {\n \"data\": {\n \"id\": \"248c7776-bd9f-4075-8980-461b02ed3757\",\n \"type\": \"flow\"\n }\n }\n },\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-03-29T10:33:24.056Z\",\n \"updated_at\": \"2018-03-29T10:33:24.056Z\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ef899d9-fd5b-41c6-9ab2-56b2c087051e", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b40824d-6ba3-4f40-97fd-ee2427892035", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "fields" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Entries", "description": "### Entries in Commerce\n\nEntries hold the pieces of data collected within the fields. If your flow has more than one field related to it, you see multiple field slugs.\n\n### Entries in Product Experience Manager\n\nEntries hold the pieces of data collected within the attributes. If your template has more than one attribute related to it, you see multiple attribute slugs.\n", "item": [ { "id": "d990ce2b-185e-4578-9064-c727953748f1", "name": "Get all Entries", "request": { "name": "Get all Entries", "description": { "content": "- For Commerce, this endpoint retrieves all entries for a flow.\n- For Product Experience Manager, this endpoint retrieves all entries for a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a71e7325-8137-47e9-8dc4-47b7959c005c", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ce1f0b19-23c3-487b-aa2a-552b77abdf0c\",\n \"type\": \"entry\",\n \"brand-image\": \"https://files-eu.epusercontent.com/e8c53cb0-120d-4ea5-8941-ce74dec06038/61118f21-14a2-466c-a84b-c30b1f900cf9.png\",\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-06-05T20:58:25.596Z\",\n \"updated_at\": \"2018-06-05T20:58:25.596Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/brands/entries/ce1f0b19-23c3-487b-aa2a-552b77abdf0c\"\n }\n },\n {\n \"id\": \"a5fcf6bc-233f-44d7-a3b0-0961eed3df9d\",\n \"type\": \"entry\",\n \"brand-image\": \"some image for brand x\",\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-06-06T14:48:59.006Z\",\n \"updated_at\": \"2018-06-06T14:48:59.006Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/brands/entries/a5fcf6bc-233f-44d7-a3b0-0961eed3df9d\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4d227be-5a89-4562-91a3-e077bf3a8745", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45ed2008-8df1-477f-a5d9-66be23650c9a", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e1d24eb-da74-49f7-a197-d4f2358f28cd", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f7d1b35-2c36-4338-9d48-8050d9de568f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a256e856-bea5-449a-89f6-38e49f08f1c1", "name": "Create an Entry", "request": { "name": "Create an Entry", "description": { "content": "- For Commerce, this endpoint creates an entry for a flow.\n- For Product Experience Manager, this endpoint creates an entry for a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1e594a6b-a827-452c-918e-1c2a94d95bb6", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"10fe2aca-09fb-42fe-a1d4-081134320641\",\n \"type\": \"entry\",\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2021-10-26T17:10:56.329Z\",\n \"updated_at\": \"2021-10-26T17:10:56.329Z\"\n }\n },\n \"links\": {\n \"self\": \"https://epcc-integration.global.ssl.fastly.net/v2/flows/products/entries/10fe2aca-09fb-42fe-a1d4-081134320641\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff49beb1-3964-49f4-b667-5866f7647b96", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afb2164e-68e4-47d4-9eee-25df7dd3a4a8", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dc3d2cf-9bd9-41a9-908e-8355697e8d16", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c667a0c-3658-4318-93c0-67186a2229df", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template you want to create an entry for.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD_SLUG\": \"a value\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2d5c7f22-4b50-4731-a615-29a8cd71350b", "name": "Get an Entry", "request": { "name": "Get an Entry", "description": { "content": "- For Commerce, this endpoint retrieves an entry from a flow.\n- For Product Experience Manager, this endpoint retrieves an entry from a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1bd8ed13-68fa-45fe-9a4b-f15f2e99dd56", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4abb8316-d0a2-4c91-bf29-4d19ba932227\",\n \"type\": \"entry\",\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-05-10T15:28:59.192Z\",\n \"updated_at\": \"2018-05-10T15:28:59.192Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/products/entries/4abb8316-d0a2-4c91-bf29-4d19ba932227\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8625d253-0418-44e0-b75b-c1110cfc91ac", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b116ae0-ed6e-466b-b729-eb0537c700cb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ffcf6321-4ebc-493b-bc58-5963fad3954b", "name": "Delete an Entry", "request": { "name": "Delete an Entry", "description": { "content": "- For Commerce, this endpoint deletes an entry from a flow.\n- For Product Experience Manager, this endpoint deletes an entry from a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "db05e556-1cce-4e9b-b031-44dc5c2d1601", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "91d65257-d93e-4a4e-98c9-8e09c0a914de", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a863a063-5fa7-4d6b-b6b2-1569a8f24e14", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ee0a5234-2c6d-4179-8937-9ea750f93b74", "name": "Update an Entry", "request": { "name": "Update an Entry", "description": { "content": "- For Commerce, this endpoint updates an entry for a flow.\n- For Product Experience Manager, this endpoint updates an entry for a template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD1_SLUG\": \"value1\",\n \"FIELD2_SLUG\": \"value2\",\n \"id\": \"{{entryID}}\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ad3258e4-011d-4d2e-9331-02f2425fdc25", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD1_SLUG\": \"value1\",\n \"FIELD2_SLUG\": \"value2\",\n \"id\": \"{{entryID}}\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"03224af8-da41-4761-99fb-a125fa81ed99\",\n \"type\": \"entry\",\n \"brand-image\": \"a new image\",\n \"meta\": {\n \"owner\": \"organization\",\n \"timestamps\": {\n \"created_at\": \"2018-06-06T14:42:39.312Z\",\n \"updated_at\": \"2018-06-06T14:42:39.312Z\"\n }\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/flows/brands/entries/03224af8-da41-4761-99fb-a125fa81ed99\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0623ff87-e4f4-4461-adcb-a81db3051e59", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD1_SLUG\": \"value1\",\n \"FIELD2_SLUG\": \"value2\",\n \"id\": \"{{entryID}}\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17fe5259-b406-41ed-9fb9-c250730ff781", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD1_SLUG\": \"value1\",\n \"FIELD2_SLUG\": \"value2\",\n \"id\": \"{{entryID}}\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d598fad6-80d2-4bf3-9cbd-f911fce7a34a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug for the flow/template.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"FIELD1_SLUG\": \"value1\",\n \"FIELD2_SLUG\": \"value2\",\n \"id\": \"{{entryID}}\",\n \"type\": \"entry\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Entry Relationships", "description": "\n### Entry Relationships in Commerce\n\nWhen you create a field that uses `relationship` as a `field_type`, you update your entry values using the `Entry Relationship` endpoints. \n\n### Entry Relationships in Product Experience Manager\n\nOnce you have created your templates, you must associate them with your products using the `Entry Relationship` endpoints.\n", "item": [ { "id": "0508846d-34c2-4c5e-aa25-5c453b5fd44e", "name": "Create an Entry Relationship", "request": { "name": "Create an Entry Relationship", "description": { "content": "- In Commerce, create an entry relationship to one or more resources. If any relationships already exist, the ones made in the request are added to them.\n- In Product Experience Manager, create an entry relationship with the product to which you want to associate the template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowFieldSlug", "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "168f6891-e98c-4847-a384-bd5357e9a30f", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"brand\",\n \"id\": \"0d28e5b6-f615-4e1c-b038-275cfde97927\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e92a7b4-bfe9-4c23-b84c-85f3986d1067", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd5b64d1-2ad3-4dc5-a97e-6de3dd843a83", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56413a72-cb83-4e6b-b02f-cd314c1cadc0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3fefcee8-ce4c-4d20-8264-8fe4b32a4cca", "name": "Update an Entry Relationship", "request": { "name": "Update an Entry Relationship", "description": { "content": "- In Commerce, updates an entry relationship to one or more resources. If any relationships already exist, the ones made in the request are added to them.\n- In Product Experience Manager, updates an entry relationship with the product to which you want to associate the template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowFieldSlug", "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1ef956ea-d9d3-41cb-84fa-a190988bccb9", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"brand\",\n \"id\": \"0d28e5b6-f615-4e1c-b038-275cfde97927\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03216125-c5ab-44f4-b1b3-055bbe057edc", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5976fa4-d6db-469a-9208-c9756a3facb6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c526bab-d69a-4569-a2b7-9b63c3a5b947", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n },\n {\n \"id\": \"{RESOURCE_ID}\",\n \"type\": \"{RESOURCE_TYPE}\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "97eee9c7-2e3b-48f5-bebe-c4b1c4e5ee7f", "name": "Delete an Entry Relationship", "request": { "name": "Delete an Entry Relationship", "description": { "content": "- In Commerce, deletes an entry relationship to one or more resources. \n- In Product Experience Manager, deletes an entry relationship with the product to which you want to associate the template.\n", "type": "text/plain" }, "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "flowSlug", "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowEntryID", "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "flowFieldSlug", "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "ed90f888-c3f9-4db6-ab9e-6027e388e71a", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f463a20f-03f3-4eac-9f4d-4325952f8c8e", "name": "Bad request. Not Found.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7efd5cf2-7850-45ea-8266-3dfa9fbdc239", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "flows", ":flowSlug", "entries", ":flowEntryID", "relationships", ":flowFieldSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the flow/template that the entry belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowSlug" }, { "disabled": false, "description": { "content": "(Required) The slug of the field/attribute that the relationship belongs to.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowFieldSlug" }, { "disabled": false, "description": { "content": "(Required) The ID of the entry you are requesting.", "type": "text/plain" }, "type": "any", "value": "string", "key": "flowEntryID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Integrations", "description": "Setting up and managing integrations.", "item": [ { "id": "fdd61fd0-3e24-4a61-8651-15b8c5fa0d65", "name": "List integrations", "request": { "name": "List integrations", "description": { "content": "Returns a list of all integrations created by the store.", "type": "text/plain" }, "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1ca952ec-139a-4dc5-9a08-a94cbca53161", "name": "Success. All integrations are returned.", "originalRequest": { "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"2da46671-b4c2-44ac-b133-d1221aafc77b\",\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"links\": {\n \"self\": \"https://vMtXyRsJyTY.blCGlBSkpocb9f,RDwNutyOox0CU0vgN06aDhp.hgHFF2yhB\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n },\n {\n \"id\": \"2da46671-b4c2-44ac-b133-d1221aafc77b\",\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"links\": {\n \"self\": \"https://sHXm.cjZXlV1P0Y5wFf7PHXmAu7CZ1svlN1K\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n }\n ],\n \"links\": {\n \"first\": \"/integrations?page[offset]=0&page[limit]=10\",\n \"last\": \"/integrations?page[offset]=20&page[limit]=10\",\n \"next\": \"/integrations?page[offset]=10&page[limit]=10\",\n \"prev\": \"/integrations?page[offset]=8&page[limit]=10\"\n },\n \"results\": {\n \"total\": 1\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3d67f22-3de2-4ec9-9cc3-01e2071153d7", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b0ba4bbe-b1f4-4b25-bb5a-64901ce0f130", "name": "Create an integration", "request": { "name": "Create an integration", "description": { "content": "Create an integration.", "type": "text/plain" }, "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"integration_type\": \"webhook\",\n \"name\": \"Order shipping notification\",\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"observes\": [\n \"string\",\n \"string\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2758009b-4230-486c-b269-702afca4f3f7", "name": "Success. Integration created.", "originalRequest": { "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"integration_type\": \"webhook\",\n \"name\": \"Order shipping notification\",\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"observes\": [\n \"string\",\n \"string\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2da46671-b4c2-44ac-b133-d1221aafc77b\",\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"links\": {\n \"self\": \"https://EL.azgxbH.+m..QVMid3e0AYoMX.OE7o0m9r8ywBi4SuLk5g\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "798806d9-1e83-47f6-be74-f9c1105b5326", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"integration_type\": \"webhook\",\n \"name\": \"Order shipping notification\",\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"observes\": [\n \"string\",\n \"string\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd5e096b-db11-4a6d-b2eb-1ebe903c2111", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"integration_type\": \"webhook\",\n \"name\": \"Order shipping notification\",\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"observes\": [\n \"string\",\n \"string\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "926f3a0a-f8c5-47f3-a02c-523d44f02a66", "name": "Get an integration", "request": { "name": "Get an integration", "description": { "content": "Returns the integration for the given UUID.", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "10f877d7-6cbd-4976-aaf9-999142c754b2", "name": "Success. An integration is returned.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2da46671-b4c2-44ac-b133-d1221aafc77b\",\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"links\": {\n \"self\": \"https://EL.azgxbH.+m..QVMid3e0AYoMX.OE7o0m9r8ywBi4SuLk5g\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2686b01-394e-4d0b-817c-d668a92a9a3b", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"The resource could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b39bc62-cb0b-4eb9-bcae-67145dc8ce4e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8a2ae9e6-e324-435f-9808-4f8405a54cb9", "name": "Update an integration", "request": { "name": "Update an integration", "description": { "content": "Updates the Integration for the given UUID. Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the integration is not updated.", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "45f61d0e-7510-4e31-8ad2-6eb762536c76", "name": "Success. All integrations are returned", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2da46671-b4c2-44ac-b133-d1221aafc77b\",\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n },\n \"links\": {\n \"self\": \"http://QuAyHYRgTNxLckblAnzyuRfn.eyjLIElHnP0+jrWlIEL6yBkwM-QAX0oHAbD3E8XVlGJupBD7O7-\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n },\n \"links\": {\n \"links\": {\n \"self\": \"http://ZJka.dzmbLFaEmml0mAptFTynLUWpXU8FIKAIUAyd-FS.3jt7KayxA,YKZYJGQCv2KRU9myQ\"\n }\n },\n \"meta\": {\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-07-21T17:32:28Z\",\n \"updated_at\": \"2017-07-21T17:32:28Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a778a61a-50b5-49bc-b55c-cb8658fc5291", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"The resource could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "332fbbf3-4718-4f7c-9a12-4191193d5128", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77d68523-a3e3-4156-b473-d5c0360b384c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"integration\",\n \"name\": \"Order shipping notification\",\n \"description\": \"Send a shipping notification via email with discount code\",\n \"enabled\": true,\n \"integration_type\": \"webhook\",\n \"observes\": [\n \"string\",\n \"string\"\n ],\n \"configuration\": {\n \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n \"aws_access_key_id\": \"****************JIMB\",\n \"aws_secret_access_key\": \"************************************HK4o\",\n \"region\": \"eu-west-1\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5c650bca-ca20-470a-bbf3-a84c0f1a9a5f", "name": "Delete an integration", "request": { "name": "Delete an integration", "description": { "content": "Deletes the Integration for the given UUID", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "7654a957-b933-443e-bcef-4913ff58d8c4", "name": "Integration was successfully deleted", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6d294026-c398-4132-9336-c0279d1594af", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "87ea0b47-a846-46ed-9185-ac5d99005637", "name": "List logs for all integrations for the store", "request": { "name": "List logs for all integrations for the store", "description": { "content": "Returns all integration logs for the store.", "type": "text/plain" }, "url": { "path": [ "integrations", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fde3fe03-6bae-4a27-853c-4934fa2535ea", "name": "Success. Returns a list of integration logs.", "originalRequest": { "url": { "path": [ "integrations", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n },\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"first\": \"/integrations/logs?page[offset]=0&page[limit]=10\",\n \"next\": \"/integrations/logs?page[offset]=10&page[limit]=10\",\n \"prev\": \"/integrations/logs?page[offset]=8&page[limit]=10\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5af2144c-5924-47bf-aac1-b86b3cd92a4c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b7edcd44-2c25-4750-968c-a519d4c96acb", "name": "List logs for integration", "request": { "name": "List logs for integration", "description": { "content": "Returns the logs for the given integration UUID.", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e97e6135-a73d-4784-aebd-ac5082205e1b", "name": "Success. Returns a list of integration logs.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n },\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"first\": \"/integrations/logs?page[offset]=0&page[limit]=10\",\n \"next\": \"/integrations/logs?page[offset]=10&page[limit]=10\",\n \"prev\": \"/integrations/logs?page[offset]=8&page[limit]=10\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e2cc889-230a-44a5-9686-6f9ab5526bf4", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"The resource could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d4ff30c-8662-494c-8d6e-2e6b2ad1d47b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d92695c6-5ab1-4c19-bf25-ffecf2dc14bd", "name": "List jobs for integration", "request": { "name": "List jobs for integration", "description": { "content": "Returns the jobs for the given integration UUID.", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "31185a72-0b23-4ce3-9d55-2a69c44bf541", "name": "Success. All integrations are returned.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8848646b-2745-469e-8cc1-ee3b04738f8f\",\n \"type\": \"integration-job\"\n },\n {\n \"id\": \"8848646b-2745-469e-8cc1-ee3b04738f8f\",\n \"type\": \"integration-job\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a16ac95-da7f-4b4b-b350-19e58d2414ec", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"The resource could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0407c6d-a702-43ee-98bc-5db4f2c027fb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "13cfafed-3c44-4579-9db1-be52138708f2", "name": "List logs for the job", "request": { "name": "List logs for the job", "description": { "content": "Returns the integration logs for the given integration and job UUID.", "type": "text/plain" }, "url": { "path": [ "integrations", ":integration_uuid", "jobs", ":job_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "integration_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "job_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the integration job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "196cc14c-1cfe-40ec-bc00-57cd33bd5df4", "name": "Success. Returns a list of integration logs.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs", ":job_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n },\n {\n \"id\": \"ac8bb58e-2b9b-4ccf-9dd2-ecdf50417849\",\n \"type\": \"integration\",\n \"succeeded\": true,\n \"attempt\": 1,\n \"body\": \"Not Found\",\n \"status_code\": 404,\n \"error_detail\": \"Received a status code outside of 2xx range - treating webhook as a fail\",\n \"relationships\": {\n \"integration\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"integration\"\n }\n },\n \"job\": {\n \"data\": {\n \"id\": \"ff8634a8-a89e-4eac-baab-9b7b8c4f8720\",\n \"type\": \"job\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"first\": \"/integrations/logs?page[offset]=0&page[limit]=10\",\n \"next\": \"/integrations/logs?page[offset]=10&page[limit]=10\",\n \"prev\": \"/integrations/logs?page[offset]=8&page[limit]=10\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "799ee12f-ab40-4b72-8020-7095ec316505", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs", ":job_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"The resource could not be found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f9e5162-e41a-4e38-b839-9faf4638640f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "integrations", ":integration_uuid", "jobs", ":job_uuid", "logs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration.", "type": "text/plain" }, "type": "any", "value": "string", "key": "integration_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the integration job.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": 500\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Inventory", "description": "The Inventory API allows you to manage stock for products at both organization and store levels. Each product keeps a history of inventory transactions, enabling easier stock auditing.\n\nYou can specify an initial stock level when you create a product. The stock is set to `0` by default.\n\n:::caution \n\nYou cannot create multiple inventories of the same organization-level product in different stores because no unique stock ID, specific to each store, is currently generated. Hence, when you try to manage inventory of the same product for different stores, you get an invalid product identifier error. \n\n:::\n", "item": [ { "id": "0bd0854d-6b77-4370-88ca-c40fad35ffbc", "name": "Get Stock for all Products", "request": { "name": "Get Stock for all Products", "description": { "content": "Returns all products and their associated stock.", "type": "text/plain" }, "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "54785039-487b-4f7a-9bba-dbcbe003423b", "name": "Success. All products and their stock values are returned", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"stock\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"total\": 100,\n \"available\": 75,\n \"allocated\": 25,\n \"stock_id\": \"ce9049af-bba2-4db2-8118-5df5268184c7\",\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n {\n \"type\": \"stock\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"total\": 100,\n \"available\": 75,\n \"allocated\": 25,\n \"stock_id\": \"ce9049af-bba2-4db2-8118-5df5268184c7\",\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n ],\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9ffdf2a-ec29-40f8-bc41-60843593a618", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52885a22-a7c5-4f9e-9c4f-90c9148faeb8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cfa51e13-45e0-465d-9256-1a5fe266e17a", "name": "Get Stock for Multiple Products", "request": { "name": "Get Stock for Multiple Products", "description": { "content": "Returns stock for all products matching the supplied unique identifiers.", "type": "text/plain" }, "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dac2fbda-ed43-4590-80e1-2ae29f579a96", "name": "Success. Multiple products and their stock values are returned.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\",\n \"type\": \"stock\",\n \"total\": 100,\n \"available\": 75,\n \"allocated\": 25\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\",\n \"type\": \"stock\",\n \"total\": 22,\n \"available\": 18,\n \"allocated\": 4\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a319a5e0-15a4-46b1-9795-b38f187ed8f8", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "129ad009-0808-446e-995b-a2d071a28f6a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fd487607-968b-4477-9ff2-dc462c53c99e", "name": "Create Stock for Product", "request": { "name": "Create Stock for Product", "description": { "content": "Sets the inventory quantity for the specified product. When you take this action, you are choosing to manage the inventory for this product in Commerce.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "73a5fb07-d424-45b5-bda2-89f8e33c9579", "name": "Success. Stock was successfully created for product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"stock\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"total\": 100,\n \"available\": 75,\n \"allocated\": 25,\n \"stock_id\": \"ce9049af-bba2-4db2-8118-5df5268184c7\",\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "471f0390-e814-4a12-b258-cbfd69b0cc0b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b97ac184-9af0-40f2-af73-526b569cc581", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a374b691-f68e-4b44-9940-f00cace90ac1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "525ab31b-4e04-4edc-af92-3ed70ec9e8cf", "name": "Get Stock for Product", "request": { "name": "Get Stock for Product", "description": { "content": "Gets the stock for the product matching the specified unique identifier.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0e2e938b-7b0a-4436-aa24-8de1babe1c2e", "name": "Success. Returns the stock for the given product UUID", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"stock\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"total\": 100,\n \"available\": 75,\n \"allocated\": 25,\n \"stock_id\": \"ce9049af-bba2-4db2-8118-5df5268184c7\",\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10565249-aba3-4a72-9783-6b86b4103a36", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f87f2aa2-8195-4edd-9fc0-21f20c39865e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "83225605-630f-43a2-8a77-fc6119572607", "name": "Delete Stock for Product", "request": { "name": "Delete Stock for Product", "description": { "content": "Deletes the inventory for the specified product. The product inventory is null and is no longer managed by Commerce. If you want to keep managing inventory but have none of the product in stock, set the inventory to `0` instead of deleting the inventory.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "13e54bbd-dfaa-4407-9fac-4b8fd7cbeea1", "name": "Success. Removes the stock information about the product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "902aca50-a090-4389-8c46-153b49a065a9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3edc6438-ba40-4728-8f53-73f0e79093b5", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d50d5453-3638-477d-a5eb-bccb66ac17b2", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Transactions", "description": "Methods to allow you to modify and view a products stock via transactions.", "item": [ { "id": "d126dd8b-b615-4964-8461-054dde4212c2", "name": "Get Stock Transactions for Product", "request": { "name": "Get Stock Transactions for Product", "description": { "content": "Returns the transactions recorded for the specified product.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3a9bd4df-2ec4-4a39-a763-8b1ff4e27154", "name": "Success. Returns the stock for the given product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"data\": [\n {\n \"type\": \"stock-transaction\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"action\": \"allocate\",\n \"product_id\": \"86b84d3e-0a86-43d6-a347-78ba4adacca2\",\n \"quantity\": 5,\n \"timestamps\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n {\n \"type\": \"stock-transaction\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"action\": \"allocate\",\n \"product_id\": \"86b84d3e-0a86-43d6-a347-78ba4adacca2\",\n \"quantity\": 5,\n \"timestamps\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a01e4cb-a562-42b1-ada0-05e46c67cd3e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f44c0bba-239c-4244-8da8-1b896bb5cba0", "name": "Create Stock Transaction on Product", "request": { "name": "Create Stock Transaction on Product", "description": {}, "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"action\": \"allocate\",\n \"type\": \"stock-transaction\",\n \"product_id\": \"b9ad64bd-fc21-4918-b6ec-768809f4a1e9\",\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7860c45a-c647-4f37-9008-ba34b01a82fd", "name": "Success. Stock was successfully modified for product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"action\": \"allocate\",\n \"type\": \"stock-transaction\",\n \"product_id\": \"b9ad64bd-fc21-4918-b6ec-768809f4a1e9\",\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"action\": \"allocate\",\n \"product_id\": \"86b84d3e-0a86-43d6-a347-78ba4adacca2\",\n \"quantity\": 5,\n \"timestamps\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbd00bb3-52c1-412a-94f8-9b73d8f2c161", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"action\": \"allocate\",\n \"type\": \"stock-transaction\",\n \"product_id\": \"b9ad64bd-fc21-4918-b6ec-768809f4a1e9\",\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffc6eadb-1bfa-4772-b381-ceda63a55ec0", "name": "The request was understood, but could not be processed by the server", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"action\": \"allocate\",\n \"type\": \"stock-transaction\",\n \"product_id\": \"b9ad64bd-fc21-4918-b6ec-768809f4a1e9\",\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Cannot complete request\",\n \"status\": \"422\",\n \"detail\": \"Your request could not be completed due to insufficient stock levels\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "648780f6-26d0-48ad-9969-9908081bdc5e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"action\": \"allocate\",\n \"type\": \"stock-transaction\",\n \"product_id\": \"b9ad64bd-fc21-4918-b6ec-768809f4a1e9\",\n \"quantity\": 5\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "59298b41-9aa9-4eb0-b59f-85828e0cc5f3", "name": "Get Single Stock Transaction for Product", "request": { "name": "Get Single Stock Transaction for Product", "description": { "content": "Returns the specific transaction with transaction_uuid for product_uuid", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "db28d5ea-7d45-4336-a385-1e06acfa8b8e", "name": "Success. Returns the stock transaction for the given product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"id\": \"f976dace-450f-4a5d-8877-d119c5a550a1\",\n \"action\": \"allocate\",\n \"product_id\": \"86b84d3e-0a86-43d6-a347-78ba4adacca2\",\n \"quantity\": 5,\n \"timestamps\": {\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eabb6948-942e-4b01-89e9-5b4fbbb598b9", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No stock found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "183bd0b9-8fb6-419a-b708-8aa0d50411a6", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Inventory", "description": "The Inventory API allows you to manage stock for products at both organization and store levels. Each product keeps a history of inventory transactions, enabling easier stock auditing.\n\nYou can specify an initial stock level when you create a product. The stock is set to `0` by default.\n\n:::caution \n\nYou cannot create multiple inventories of the same organization-level product in different stores because no unique stock ID, specific to each store, is currently generated. Hence, when you try to manage inventory of the same product for different stores, you get an invalid product identifier error. \n\n:::\n", "item": [ { "id": "66afafe3-287f-4626-a313-a8ec8390e0f3", "name": "Create Stock for Product", "request": { "name": "Create Stock for Product", "description": { "content": "Sets the inventory quantity for the specified product.", "type": "text/plain" }, "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"locations\": {\n \"york_warehouse\": {\n \"available\": 10\n },\n \"stevenage_warehouse\": {\n \"available\": 20\n }\n }\n },\n \"id\": \"00000000-0000-0000-0000-000000000000\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6d30210b-d994-4a78-84f4-9110e779aab2", "name": "Success. Stock was successfully created for product", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"locations\": {\n \"york_warehouse\": {\n \"available\": 10\n },\n \"stevenage_warehouse\": {\n \"available\": 20\n }\n }\n },\n \"id\": \"00000000-0000-0000-0000-000000000000\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_2\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_3\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_4\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d86e34ef-a3ab-4df3-8228-a12f957e8b63", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"locations\": {\n \"york_warehouse\": {\n \"available\": 10\n },\n \"stevenage_warehouse\": {\n \"available\": 20\n }\n }\n },\n \"id\": \"00000000-0000-0000-0000-000000000000\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f10e795f-e3a9-4ac7-8db3-df98c39ed383", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"locations\": {\n \"york_warehouse\": {\n \"available\": 10\n },\n \"stevenage_warehouse\": {\n \"available\": 20\n }\n }\n },\n \"id\": \"00000000-0000-0000-0000-000000000000\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c5bbbb37-65b3-4309-a109-5fba68b0c284", "name": "Get Stock for all Products", "request": { "name": "Get Stock for all Products", "description": { "content": "Returns all products and their associated stock.", "type": "text/plain" }, "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3a570695-ac1e-4202-a929-0ca7510d0746", "name": "Success. All products and their stock values are returned", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n },\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_2\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_3\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c99b178-6b25-4ab6-be2d-2474beb77221", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0dcc9a3-56fc-4b8f-9240-777466c1c9e9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "20c961c5-269c-420d-b898-e82edf4f79f7", "name": "List Stock", "request": { "name": "List Stock", "description": { "content": "Returns stock for all products matching the supplied unique identifiers.", "type": "text/plain" }, "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8c39148b-f715-4996-8e38-203cbba9baa6", "name": "Success. Multiple products and their stock values are returned.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_2\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n },\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae3337ca-7328-4ac4-9757-d521cf3cacc2", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01505cec-4f8e-45b6-a074-9dad49184a4b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "multiple" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\"\n },\n {\n \"id\": \"5334e697-a576-4ac5-8075-ab457dfcaddd\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "97dc95df-d041-4769-844d-a299973cbed3", "name": "Get Stock for Product", "request": { "name": "Get Stock for Product", "description": { "content": "Gets the stock for the product matching the specified unique identifier.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a43dfab5-f3d4-40d9-9813-c48500c93e44", "name": "Success. Returns the stock for the given product UUID", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_2\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_3\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_4\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ac946ce-0c55-4b82-8708-fcc872a95354", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55d04569-9d3c-4908-bb3c-85f8cca904fc", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2dc0cb12-f826-4db2-ab82-e133413b6e17", "name": "Update Stock for Product", "request": { "name": "Update Stock for Product", "description": { "content": "Updates the inventory for the specified product.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"locations\": {\n \"key_0\": {\n \"available\": 20\n },\n \"key_1\": {\n \"available\": 20\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8f2b7c72-9470-4907-b342-0028f9a6a0f5", "name": "Success. The stock item was updated successfully.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"locations\": {\n \"key_0\": {\n \"available\": 20\n },\n \"key_1\": {\n \"available\": 20\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10,\n \"locations\": {\n \"key_0\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_1\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_2\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_3\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n },\n \"key_4\": {\n \"available\": 20,\n \"total\": 30,\n \"allocated\": 10\n }\n }\n },\n \"meta\": {\n \"stock_id\": \"00000000-0000-0000-0000-000000000000\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb900a46-a4de-4e4c-9ddb-5652cb71572a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"locations\": {\n \"key_0\": {\n \"available\": 20\n },\n \"key_1\": {\n \"available\": 20\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7f50c6a-bbea-4a52-98e7-15d36f333500", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"locations\": {\n \"key_0\": {\n \"available\": 20\n },\n \"key_1\": {\n \"available\": 20\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ed934f0-7847-4c7b-8833-e7075be8a26e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock\",\n \"attributes\": {\n \"locations\": {\n \"key_0\": {\n \"available\": 20\n },\n \"key_1\": {\n \"available\": 20\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f02eaeb9-fbee-4bfd-9202-7cff9ab9696c", "name": "Delete Stock for Product", "request": { "name": "Delete Stock for Product", "description": { "content": "Deletes the inventory for the specified product. The product inventory is null and is no longer managed by Commerce. If you want to keep managing inventory but have none of the product in stock, set the inventory to `0` instead of deleting the inventory.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "d3c9fb1f-e1e8-423d-8594-529586ef4b7c", "name": "Success. Removes the stock information about the product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "87f31c28-9d31-4559-b3da-aa438b81540f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9051182c-23fa-4b74-ab84-516fe250df48", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7d45f73-e4fd-48bd-ad7c-7506cd99754f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Transactions", "description": "Methods to allow you to modify and view a products stock via transactions.", "item": [ { "id": "e3e7016f-8176-4f4d-91e6-1f7b94756bb7", "name": "Get Stock Transactions for Product", "request": { "name": "Get Stock Transactions for Product", "description": { "content": "Returns the transactions recorded for the specified product.", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "da7316c1-e6ae-4858-8af5-ad43a1d5f945", "name": "Success. Returns the stock for the given product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"quantity\": 5,\n \"location\": \"milton-keynes-warehouse\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n },\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"quantity\": 5,\n \"location\": \"milton-keynes-warehouse\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "911b1fb6-bff5-4c4e-81b5-b9770813f5c0", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7fdda895-012a-4d06-a93e-e63dbcc54485", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e4d5296-fb62-453e-9e31-78bced45c1df", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0a609dc4-8cff-4543-8873-f5050b506146", "name": "Create Stock Transaction on Product", "request": { "name": "Create Stock Transaction on Product", "description": {}, "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "b46f3976-07ce-4a73-a8fe-69db07d87abe", "name": "Success. Stock was successfully created for product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"quantity\": 5,\n \"location\": \"milton-keynes-warehouse\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "557177df-fa73-4c4a-8bbe-b7de76085513", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7559b7e8-11d6-4a23-ba5f-478adb696416", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0eec51a-9273-4d49-bad9-06a0646b216e", "name": "The request was understood, but could not be processed by the server", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Cannot complete request\",\n \"status\": \"422\",\n \"detail\": \"Your request could not be completed due to insufficient stock levels\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9eb9fe0-d2d3-4c11-a030-d8beec7326db", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"quantity\": 5,\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"location\": \"milton-keynes-warehouse\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "673def8b-d206-4c66-9237-c456f756e31e", "name": "Get Single Stock Transaction for Product", "request": { "name": "Get Single Stock Transaction for Product", "description": { "content": "Returns the specific transaction with transaction_uuid for product_uuid", "type": "text/plain" }, "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5d49f183-482f-4a7d-99e0-2bf666ad144d", "name": "Success. Returns the stock transaction for the given product", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"stock-transaction\",\n \"attributes\": {\n \"action\": \"allocate\",\n \"product_id\": \"00000000-0000-0000-0000-000000000000\",\n \"quantity\": 5,\n \"location\": \"milton-keynes-warehouse\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6d75c3d-3b20-4902-a383-9a91629db865", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f68cfc6c-8552-4db0-8821-b57f719dc170", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", ":product_uuid", "transactions", ":transaction_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "product_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the transaction.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "transaction_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Imports", "description": "You can import stock positions for up to 50,000 products in a single operation via an import. This is useful for synchronosing external systems with Elastic Path.\nThe API uses a [**JSONL**](https://jsonlines.org/) file, with one line per product. For each product one specifies the total stock in each location. For example\n\n```\n{\"data\":{\"type\":\"stock\",\"id\":\"b36ba644-6fdc-49b3-9ebb-410ed34908a8\",\"attributes\":{\"locations\":{\"vancouver\":{\"total\":20}}}}}\n{\"data\":{\"type\":\"stock\",\"id\":\"2e5a4c7b-6f88-4aad-a3c2-4d8b29bc32a4\",\"attributes\":{\"locations\":{\"vancouver\":{\"total\":54},\"denver\":{\"total\":1},\"boston\":{\"total\":20},\"portland\":{\"total\":100}}}}}\n```\n\n### Characteristics of Inventories Import\n\nThe Inventories Import API has the following characteristics:\n\n- The Inventories Import API reads the entire file and then updates the inventory.\n\n- Inventories imports are asynchronous and are processed one at a time. You can continue to send import requests, but these are queued. \n\n- If a product in an import does not already exist in the inventories database it will be created.\n", "item": [ { "id": "3912f9b5-b03e-4dea-90c4-8bc71450e17b", "name": "Import a dataset", "request": { "name": "Import a dataset", "description": {}, "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] }, "auth": null }, "response": [ { "id": "2b661975-e4f1-4eb5-9568-2a1c3ab1a6a5", "name": "Success. The import was started.", "originalRequest": { "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"stock\": 50000\n },\n \"imported\": {\n \"stock\": 50000\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85705cf4-4183-47db-80d4-8af7377cb1da", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35a4f840-60ff-49c0-9160-d97d07ca4b47", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "02e234a4-b679-4653-a1d4-b5b7bee38698", "name": "List import jobs", "request": { "name": "List import jobs", "description": { "content": "Retrieves a list of all import jobs.\n", "type": "text/plain" }, "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "dc4f2da5-c20f-49df-bc15-1ab531f05a6f", "name": "Success. A list of import jobs is returned.", "originalRequest": { "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"stock\": 50000\n },\n \"imported\": {\n \"stock\": 50000\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n }\n },\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"stock\": 50000\n },\n \"imported\": {\n \"stock\": 50000\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0210d71-169f-4056-92fa-3b6e32686176", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bd653689-28e5-47e3-a691-e6bfb39c94ca", "name": "Get import", "request": { "name": "Get import", "description": { "content": "Retrieves the import job for the specified ID.", "type": "text/plain" }, "url": { "path": [ "inventories", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "49d52b7a-a260-46d2-aa6b-f3716ac2aff8", "name": "Success. The import is returned.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"stock\": 50000\n },\n \"imported\": {\n \"stock\": 50000\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2abd188-a6a1-47fa-90c3-4d83683cd3f4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c829b712-e951-4b3b-aed4-85a36f2eb9db", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5773bccd-0208-466a-be91-8c218e639230", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56b6a0ce-698a-409c-bec2-f65251494255", "name": "Get import errors", "request": { "name": "Get import errors", "description": { "content": "Retrieves all errors encountered as part of the import. Each error is attributed to a line in the JSONL file \nimported, so for example, if at line 1 in your JSONL you had a stock without locations, there would\nbe a missing key error for locations.\n\nErrors are also ordered by line number ascending, and can be paginated.\n", "type": "text/plain" }, "url": { "path": [ "inventories", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fd23e50e-3af3-4b89-bbaf-b8f42b552539", "name": "Success. The import errors are returned.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import_error\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"error\": \"product name cannot be empty\",\n \"field\": \"name\",\n \"line_number\": 123,\n \"external_ref\": \"abc123\"\n }\n },\n {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventories_import_error\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"error\": \"product name cannot be empty\",\n \"field\": \"name\",\n \"line_number\": 123,\n \"external_ref\": \"abc123\"\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc63af6b-29ba-4a24-9314-af9d0d6c832d", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d9f811f-6862-42d1-ab0f-76c85a498a64", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "inventories", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Locations", "description": "", "item": [ { "id": "135c4ea1-1c82-40ae-b90d-ccc4f9659b40", "name": "List Locations", "request": { "name": "List Locations", "description": { "content": "Lists all Inventory Locations", "type": "text/plain" }, "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "Only supported value is `location`. When specified, the results are sorted in ascending order based on the value of the field. For `location`, this means ascending distance from the supplied geolocation. For more information, see [Sorting](/guides/Getting-Started/sorting). For location sorting, `Ep-Geolocation` header must be provided as well. (This can only be one of location)", "type": "text/plain" }, "key": "sort", "value": "location" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Latitude, Longitude representing current location", "type": "text/plain" }, "key": "Ep-Geolocation", "value": "49.2847027,-123.1109329" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9100c16f-d9c9-4d2c-baa9-ab62053ed180", "name": "Success. A list of locations is returned", "originalRequest": { "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "Only supported value is `location`. When specified, the results are sorted in ascending order based on the value of the field. For `location`, this means ascending distance from the supplied geolocation. For more information, see [Sorting](/guides/Getting-Started/sorting). For location sorting, `Ep-Geolocation` header must be provided as well. (This can only be one of location)", "type": "text/plain" }, "key": "sort", "value": "location" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Latitude, Longitude representing current location", "type": "text/plain" }, "key": "Ep-Geolocation", "value": "49.2847027,-123.1109329" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"Troughton Supplies\",\n \"38 Pipernel Grove\",\n \"Walnut Tree\",\n \"MK7 4UL\"\n ],\n \"geolocation\": {\n \"lat\": -90,\n \"lon\": 180\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e04046fc-e2eb-4f60-a231-9806b3037e99", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](https://elasticpath.dev/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(location,new-york)" }, { "disabled": false, "description": { "content": "Only supported value is `location`. When specified, the results are sorted in ascending order based on the value of the field. For `location`, this means ascending distance from the supplied geolocation. For more information, see [Sorting](/guides/Getting-Started/sorting). For location sorting, `Ep-Geolocation` header must be provided as well. (This can only be one of location)", "type": "text/plain" }, "key": "sort", "value": "location" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Latitude, Longitude representing current location", "type": "text/plain" }, "key": "Ep-Geolocation", "value": "49.2847027,-123.1109329" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "077e84f4-b74f-4d3b-b372-e1156742a673", "name": "Create a Location", "request": { "name": "Create a Location", "description": { "content": "Creates an Inventory Location", "type": "text/plain" }, "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"slug\": \"milton-keynes-warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n },\n \"type\": \"inventory_location\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5875f15d-e94d-4bbb-b487-5014a9543e0c", "name": "Success. The location was created successfully", "originalRequest": { "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"slug\": \"milton-keynes-warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n },\n \"type\": \"inventory_location\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"Troughton Supplies\",\n \"38 Pipernel Grove\",\n \"Walnut Tree\",\n \"MK7 4UL\"\n ],\n \"geolocation\": {\n \"lat\": -90,\n \"lon\": 180\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11171929-9c4d-4bb3-9441-a8c2fa44d843", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", "locations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"slug\": \"milton-keynes-warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n },\n \"type\": \"inventory_location\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "159c358d-0693-4760-8fba-9a400f6f507a", "name": "Get a Location", "request": { "name": "Get a Location", "description": { "content": "Get an Inventory Location", "type": "text/plain" }, "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4e1ed74c-c0d8-4e56-bf08-2b5ecf4d3c93", "name": "Success. The location is returned", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"Troughton Supplies\",\n \"38 Pipernel Grove\",\n \"Walnut Tree\",\n \"MK7 4UL\"\n ],\n \"geolocation\": {\n \"lat\": -90,\n \"lon\": 180\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a7735a6-7d5d-424e-8cfd-a19e97f11362", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e0031db2-04bc-4ec3-8dd6-c81c90e1cc83", "name": "Update a Location", "request": { "name": "Update a Location", "description": { "content": "Updates an Inventory Location", "type": "text/plain" }, "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f7e30031-a59f-4299-9781-00e3465c55ac", "name": "Success. The location was updated successfully", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"ebc7652d-bb7d-4359-9a83-78f2998208d9\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"Troughton Supplies\",\n \"38 Pipernel Grove\",\n \"Walnut Tree\",\n \"MK7 4UL\"\n ],\n \"geolocation\": {\n \"lat\": -90,\n \"lon\": 180\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b608307f-f0e0-4148-9f4a-512bf9010e25", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"Your request was invalid\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06ced85a-617d-4b77-a25f-cf84d4d16187", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"type\": \"inventory_location\",\n \"attributes\": {\n \"name\": \"Milton Keynes Warehouse\",\n \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n \"slug\": \"milton-keynes-warehouse\",\n \"description\": \"Southern dispatch location for all inventory\",\n \"address\": [\n \"string\"\n ],\n \"geolocation\": {\n \"lat\": 51.477928,\n \"lon\": -0.001545\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No location found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "070fc40e-c18a-4dd7-aab8-d83d3e0bdfbd", "name": "Delete a Location", "request": { "name": "Delete a Location", "description": { "content": "Delete an Inventory Location", "type": "text/plain" }, "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "31610c2a-af55-4b88-b472-fee730a1c8a0", "name": "Success. The location is deleted", "originalRequest": { "url": { "path": [ "inventories", "locations", ":location_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the location.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "location_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Gateways", "description": "", "item": [ { "id": "380db4b1-2285-44c2-a26b-3f11683506fb", "name": "Get all Gateways", "request": { "name": "Get all Gateways", "description": { "content": "Retrieves all gateways.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "494aa79b-0375-42df-a2ed-5d3d1a1e4ba2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"string\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false\n },\n {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"string\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "007b34d8-55c0-4979-9efc-ec861f79cb6d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d50417b3-cafd-42dd-82e9-247ff3387eb9", "name": "Get a Gateway", "request": { "name": "Get a Gateway", "description": { "content": "Retrieves the specified gateway.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", ":gatewaySlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "stripe_payment_intents", "key": "gatewaySlug", "disabled": false, "description": { "content": "(Required) The slug of the gateway. (This can only be one of manual,braintree,stripe,stripe_payment_intents,elastic_path_payments_stripe,paypal_express_checkout,adyen,authorize_net,card_connect,cyber_source)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fd6b27b9-eff6-4779-84e5-b80705b924a1", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", ":gatewaySlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the gateway. (This can only be one of manual,braintree,stripe,stripe_payment_intents,elastic_path_payments_stripe,paypal_express_checkout,adyen,authorize_net,card_connect,cyber_source)", "type": "text/plain" }, "type": "any", "value": "stripe_payment_intents", "key": "gatewaySlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"string\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cf67083-3a94-4be2-b422-4bf1929a4245", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", ":gatewaySlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The slug of the gateway. (This can only be one of manual,braintree,stripe,stripe_payment_intents,elastic_path_payments_stripe,paypal_express_checkout,adyen,authorize_net,card_connect,cyber_source)", "type": "text/plain" }, "type": "any", "value": "stripe_payment_intents", "key": "gatewaySlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dcf076e8-031e-4b95-91f0-66ba50a0d3f6", "name": "Update Manual Gateway", "request": { "name": "Update Manual Gateway", "description": { "content": "This endpoint allows you update the manual gateway.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "manual" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "441caed4-34c4-4931-812a-f6ea567a193c", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "manual" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"name\": \"Manual\",\n \"slug\": \"manual\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b764fdf3-a8b0-4ed6-8bad-d47d53b3fb39", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "manual" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "562ebb1a-232e-4efc-820e-c9ed20550273", "name": "Update Braintree Gateway", "request": { "name": "Update Braintree Gateway", "description": { "content": "Use this endpoint to configure Braintree.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "braintree" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"environment\": \"sandbox\",\n \"merchant_id\": \"{{braintreeMerchantId}}\",\n \"private_key\": \"{{braintreePrivateKey}}\",\n \"public_key\": \"{{braintreePublicKey}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "80b6cab3-18ee-4f3b-9281-8b8cbf341ed9", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "braintree" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"environment\": \"sandbox\",\n \"merchant_id\": \"{{braintreeMerchantId}}\",\n \"private_key\": \"{{braintreePrivateKey}}\",\n \"public_key\": \"{{braintreePublicKey}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"name\": \"Braintree\",\n \"environment\": \"sandbox\",\n \"merchant_id\": \"{{braintreeMerchantId}}\",\n \"private_key\": \"{{braintreePrivateKey}}\",\n \"public_key\": \"{{braintreePublicKey}}\",\n \"slug\": \"braintree\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f712e8b5-8c42-40f6-8c0a-62940d296077", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "braintree" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"environment\": \"sandbox\",\n \"merchant_id\": \"{{braintreeMerchantId}}\",\n \"private_key\": \"{{braintreePrivateKey}}\",\n \"public_key\": \"{{braintreePublicKey}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c224d87a-b421-4c40-9bd5-9267822b79c4", "name": "Update Stripe Gateway", "request": { "name": "Update Stripe Gateway", "description": { "content": "Use this endpoint to configure Stripe.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "79f07cd9-0297-4cc0-a15c-59718ef82dc0", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeToken}}\",\n \"name\": \"Stripe\",\n \"slug\": \"stripe\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a66cdf2f-f292-4cee-b3eb-fe9f8fd9f7cc", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "696d9e87-35d2-48e3-9603-cbdd3b6538d2", "name": "Update Stripe Payment Intents Gateway", "request": { "name": "Update Stripe Payment Intents Gateway", "description": { "content": "Use this endpoint to configure Stripe Payment Intents.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "stripe_payment_intents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeLoginToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c06e24ae-c5d8-4a3c-9616-7cd31a911559", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "stripe_payment_intents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeLoginToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeLoginToken}}\",\n \"name\": \"Stripe Payment Intents\",\n \"slug\": \"stripe_payment_intents\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71225829-497e-408f-81ab-036cc671690b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "stripe_payment_intents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"{{stripeLoginToken}}\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c93ff0c7-42f5-4cfa-9759-b9f7bcb50550", "name": "Update Elastic Path Payments Powered by Stripe", "request": { "name": "Update Elastic Path Payments Powered by Stripe", "description": { "content": "Use this endpoint to configure Elastic Path Payments Powered by Stripe in Commerce. \n\n:::note\n\nYou can contact Elastic Path sales or [customer success team](mailto:customersuccess@elasticpath.com) to get more information about Elastic Path Payments Powered by Stripe and to check whether it will work for you.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "elastic_path_payments_stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"stripe_account\": \"{{stripeAccountId}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6b964e0d-d1dc-4443-8e2d-6d490e195117", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "elastic_path_payments_stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"stripe_account\": \"{{stripeAccountId}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"stripe_account\": \"{{stripeAccountId}}\",\n \"name\": \"Elastic Path Payments powered by Stripe\",\n \"test\": true,\n \"slug\": \"elastic_path_payments_stripe\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7ad1c1e-c77a-41d7-aeb7-0ae3575d42b4", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "elastic_path_payments_stripe" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"stripe_account\": \"{{stripeAccountId}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0768dd8d-aa1c-48a7-afa6-c60d41c12f7e", "name": "Update PayPal Express Checkout", "request": { "name": "Update PayPal Express Checkout", "description": { "content": "Use this endpoint to configure PayPal Express Checkout. \n:::note\n\nTo learn more about PayPal Express Checkout and check whether it will work for you, contact your sales or [customer success team](mailto:customersuccess@elasticpath.com).\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "paypal_express_checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"payer_id\": \"{{merchant account id}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8e515418-4214-4d3b-a4f5-290aafe0f486", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "paypal_express_checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"payer_id\": \"{{merchant account id}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"payer_id\": \"{{merchant account id}}\",\n \"name\": \"PayPal Express Checkout\",\n \"test\": true,\n \"slug\": \"paypal_express_checkout\",\n \"type\": \"gateway\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d8ee356-1d9a-4c5b-b192-c98623d69790", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "paypal_express_checkout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"payer_id\": \"{{merchant account id}}\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a1690759-cf3c-46a6-bae5-1f63c94e760f", "name": "Update Adyen Gateway", "request": { "name": "Update Adyen Gateway", "description": { "content": "Use this endpoint to configure Adyen.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "adyen" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"merchant_account\": \"MyCompanyECOM\",\n \"username\": \"ws@Company.MyCompany\",\n \"password\": \"xxx\",\n \"test\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "11bc2a28-615a-496b-a1c4-75b685635113", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "adyen" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"merchant_account\": \"MyCompanyECOM\",\n \"username\": \"ws@Company.MyCompany\",\n \"password\": \"xxx\",\n \"test\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"string\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false,\n \"merchant_account\": \"MyCompanyECOM\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abe438a5-6163-4f55-8e4e-0e0667482fee", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "adyen" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"merchant_account\": \"MyCompanyECOM\",\n \"username\": \"ws@Company.MyCompany\",\n \"password\": \"xxx\",\n \"test\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "53b76b35-a749-4d79-b96e-293b850ac0c7", "name": "Update Authorize.net Gateway", "request": { "name": "Update Authorize.net Gateway", "description": { "content": "\nUse this endpoint to configure Authorize.net.\n\n:::note\nThe credentials used for a test account may differ from those used for a live account. When configuring the payment gateway with your credentials and setting `test` to `true`, the system allows you to test various Authorize.net payment interactions to ensure everything works as expected. Once you are ready to go live, update `test` as `false` to direct requests to the live endpoints instead of the test account. Additionally, ensure that you switch to the credentials for the live account when making this change. To access your sandbox environment, see [Authorize.net Sandbox account](https://developer.authorize.net/hello_world/sandbox.html).\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "authorize_net" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"slug\": \"authorize_net\",\n \"enabled\": true,\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a9cbb4ce-b867-4570-807d-2a2a9999d4eb", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "authorize_net" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"slug\": \"authorize_net\",\n \"enabled\": true,\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"authorize-net-transaction-key\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e73d91de-802d-4f1b-9453-b2f4d712734b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "authorize_net" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"slug\": \"authorize_net\",\n \"enabled\": true,\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3e692d30-552b-4093-b223-1a50e7abe082", "name": "Update CardConnect Gateway", "request": { "name": "Update CardConnect Gateway", "description": { "content": "Use this endpoint to configure CardConnect.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "card_connect" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"merchant_id\": \"xxx\",\n \"username\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": false,\n \"enabled\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "14ddf8ea-4464-4920-ad32-8a20e6d12fa2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "card_connect" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"merchant_id\": \"xxx\",\n \"username\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": false,\n \"enabled\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"string\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"string\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false,\n \"merchant_id\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a21822f-ccbb-4473-a002-d555bd6801c1", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "card_connect" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"merchant_id\": \"xxx\",\n \"username\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": false,\n \"enabled\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "588101d1-cf30-417a-9bc3-50c79aee9601", "name": "Update CyberSource Gateway", "request": { "name": "Update CyberSource Gateway", "description": { "content": "Use this endpoint to configure CyberSource.", "type": "text/plain" }, "url": { "path": [ "v2", "gateways", "cyber_source" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "39df2c9d-6a41-4d1f-baee-f17afaba5365", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "gateways", "cyber_source" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"cybersource-merchant-id\",\n \"name\": \"{gatewayName}\",\n \"type\": \"gateway\",\n \"password\": \"cybersource SOAP key\",\n \"signature\": \"string\",\n \"slug\": \"{gatewaySlug}\",\n \"test\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "048a90a4-4d68-4c7b-9433-4e94e906c39d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "gateways", "cyber_source" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"enabled\": true,\n \"login\": \"xxx\",\n \"password\": \"xxx\",\n \"test\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Built-in Roles", "description": "Built-in Roles represent the various personas supported in Commerce. Some Roles pertain to store management and can be assigned to users through Commerce Manager, while others represent customers who shop at the store.\n", "item": [ { "id": "e23ea712-a3bc-4326-bc08-8a6b277ad35e", "name": "List Built-in Roles", "request": { "name": "List Built-in Roles", "description": { "content": "Retrieves a list of Built-in Roles\n", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "built-in-roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "81440309-ac1b-4652-932e-717e10791650", "name": "List of Built-in Roles", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"cm_user_assignable\": false,\n \"links\": {\n \"self\": \"http://kIEmmWTPGFWMjS.mxnsNecUHLtZObi1vxEkMZuDqvNn9ws7AP0VSMb57+mn8uPDBsm48OdjbeYhtsBV3CZStCLuHkuQ8\"\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"cm_user_assignable\": false,\n \"links\": {\n \"self\": null\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fa080e0-5ac9-4fb9-8e33-4ca7c1885e26", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39d8dc75-efe9-4919-909c-64e8ec60a273", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ee95d8e3-2c8a-4296-807d-9c315964f91b", "name": "Get a Built-in Role", "request": { "name": "Get a Built-in Role", "description": { "content": "Get a Built-in Role", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "built-in-roles", ":built-in-role-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "it-developer", "key": "built-in-role-id", "disabled": false, "description": { "content": "(Required) The ID of the Built-In Role.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ff86d576-bdac-4383-90df-e924d442c11c", "name": "A Built-in Role", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles", ":built-in-role-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Built-In Role.", "type": "text/plain" }, "type": "any", "value": "it-developer", "key": "built-in-role-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"type\": \"string\",\n \"name\": \"string\",\n \"cm_user_assignable\": false,\n \"links\": {\n \"self\": null\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4aa4104-76c2-4e9f-9e92-de53776873cd", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles", ":built-in-role-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Built-In Role.", "type": "text/plain" }, "type": "any", "value": "it-developer", "key": "built-in-role-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59905995-7346-4f27-95ef-8e45206ff502", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "built-in-roles", ":built-in-role-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Built-In Role.", "type": "text/plain" }, "type": "any", "value": "it-developer", "key": "built-in-role-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom API Role Policies", "description": "A Custom API Role Policy defines the level of access a role has to a Custom API. By default, administrative roles like **Store Admin** or **Org Admin** have full access to all Custom APIs. To grant access to other roles, a policy must be created for that specific role and Custom API.\n\nBelow are the permissions that can be assigned to a role:\n\n| Permission | Description |\n|------------|------------------------------------------|\n| **Create** | Create a Custom API Entry. |\n| **List** | Retrieve a list of Custom API Entries. |\n| **Read** | Get a Custom API Entry. |\n| **Update** | Update a Custom API Entry. |\n| **Delete** | Delete a Custom API Entry. |\n", "item": [ { "id": "d49ee0cf-7ac9-453a-be61-d4ff80a7af98", "name": "Create A Custom API Role Policy", "request": { "name": "Create A Custom API Role Policy", "description": { "content": "Create A Custom API Role Policy", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": false,\n \"delete\": true,\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"fded1d2a-8bb8-48b6-86a5-9eb05cc8626a\",\n \"type\": \"custom_api\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"built_in_role\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ab78f72b-fc3b-44ac-85d4-5d12fa0ee2e2", "name": "A Custom API Role Policy", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": false,\n \"delete\": true,\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"fded1d2a-8bb8-48b6-86a5-9eb05cc8626a\",\n \"type\": \"custom_api\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"built_in_role\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"aa24653f-2c0d-35ae-0f0e-8a6ffb2fc31b\",\n \"type\": \"string\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": true,\n \"delete\": false,\n \"links\": {\n \"self\": \"https://gqe.lkmsyZhENSF5pcz50a0t06JMSDN.0rkiBDw2eVVVGIAs,Tem\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"string\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c76ce04-f5b3-42d0-9fc2-c0068a6254ef", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": false,\n \"delete\": true,\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"fded1d2a-8bb8-48b6-86a5-9eb05cc8626a\",\n \"type\": \"custom_api\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"built_in_role\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d752936d-1a5f-4479-ac6b-49e1ebc7b5f5", "name": "Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": false,\n \"delete\": true,\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"fded1d2a-8bb8-48b6-86a5-9eb05cc8626a\",\n \"type\": \"custom_api\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"built_in_role\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"custom_api with the given api_type already exists\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15d9538b-ae55-4174-8f1d-331b6911c0d4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": false,\n \"delete\": true,\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"fded1d2a-8bb8-48b6-86a5-9eb05cc8626a\",\n \"type\": \"custom_api\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"built_in_role\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "30ed7e84-974e-4431-a839-280658c026b2", "name": "List Custom API Role Policies", "request": { "name": "List Custom API Role Policies", "description": { "content": "Retrieves a list of Custom API Role Policies\n\n## Filtering\nThe following operators and attributes are available for [filtering](/guides/Getting-Started/filtering) Custom API Role Policies:\n\n| Attribute | Operators | Example |\n|------------------|-------------------------------|----------------------------------------------------------|\n| `id` | `lt`,`le`,`eq`,`gt`,`ge`,`in` | `eq(id,3fa85f64-5717-4562-b3fc-2c963f66afa6)` |\n| `created_at` | `lt`,`le`,`eq`,`gt`,`ge` | `ge(created_at,2024-04-29T00:00:00.000Z)` |\n| `updated_at` | `lt`,`le`,`eq`,`gt`,`ge` | `le(updated_at,2024-04-29T00:00:00.000Z)` |\n| `custom_api_id` | `eq` | `eq(custom_api_id,fded1d2a-8bb8-48b6-86a5-9eb05cc8626a)` |\n| `role_id` | `eq` | `eq(role_id,it-developer)` |\n\n## Sorting\nThe following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with `-`, for example, `-updated_at`. The default sort order is `created_at` in descending order.\n- `id`\n- `created_at`\n- `updated_at`\n", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "6857" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4651" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Role Policies will be returned. (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a6d4d108-06e9-40be-8184-134ef7a4e5ed", "name": "List of Custom API Role Policies", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "6857" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4651" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Role Policies will be returned. (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"b086f6d6-3033-4029-3035-537318704a4b\",\n \"type\": \"string\",\n \"create\": true,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": true,\n \"links\": {\n \"self\": \"http://bxEnotxVsjOouzZbXFynymhMQuDj.gchchBqMusNlIf1iNsxjnF12qhHSOlPN2cadonJzTxA71k92g7NAKd6,UUgolGiuF0k\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"string\"\n }\n }\n }\n },\n {\n \"id\": \"8ccd86fc-a97a-4166-19e1-35fd736f51b3\",\n \"type\": \"string\",\n \"create\": false,\n \"list\": false,\n \"read\": true,\n \"update\": true,\n \"delete\": true,\n \"links\": {\n \"self\": \"https://sPsHiuvaRQEqzkuPdocrxJrJadBEO.fguoXwx0ifC.aGCGOgnabE1ZwVD7gdeHOMXbFKlZaolfjtCuTpXWkhMgPls\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"string\"\n }\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2971\n },\n \"page\": {\n \"limit\": 100,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n }\n },\n \"links\": {\n \"current\": \"http://OLBysLKd.udhSvHKjHLH\",\n \"first\": \"https://SU.vowg-6J9BXTWwq5,NQsP5YVMT\",\n \"last\": null,\n \"next\": \"https://sjBDNn.bbWC33gCs-l8GKGlhlM7bdhq0Rayiz+AewRoDa9wlrDjSABzv0RCANFGVepDoJ.nrdh+YJB6\",\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "206f2134-e752-4a8b-b0f2-80a666f24ee6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "6857" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4651" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Role Policies will be returned. (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]\",\n \"status\": \"400\",\n \"title\": \"Bad Request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4dcb0997-c526-4d3d-8d70-e604188ed8ee", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "6857" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/api/settings/settings-introduction#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "4651" }, { "disabled": false, "description": { "content": "Filter attributes. For more information, see the [Filtering](/guides/Getting-Started/filtering) section.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which Custom API Role Policies will be returned. (This can only be one of id,-id,created_at,-created_at,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df5f7314-bb2b-4b23-a283-65308965b251", "name": "Get a Custom API Role Policy", "request": { "name": "Get a Custom API Role Policy", "description": { "content": "Get A Custom API Role Policy", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id", "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "05dd741d-44a8-4963-9ed4-9d57dd6124c7", "name": "A Custom API Role Policy", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"aa24653f-2c0d-35ae-0f0e-8a6ffb2fc31b\",\n \"type\": \"string\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": true,\n \"delete\": false,\n \"links\": {\n \"self\": \"https://gqe.lkmsyZhENSF5pcz50a0t06JMSDN.0rkiBDw2eVVVGIAs,Tem\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"string\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2071a68-4690-4b64-b0f8-5ac8c14ffc67", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "737f3e2e-55eb-4cff-8e7b-58544ed7f524", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a9633db2-1fb6-4370-9f74-92373b6c180f", "name": "Update a Custom API Role Policy", "request": { "name": "Update a Custom API Role Policy", "description": { "content": "Update A Custom API Role Policy", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id", "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": false,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9e641512-0a6a-4d68-a0b1-8618eeb9def7", "name": "A Custom API Role Policy", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": false,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"aa24653f-2c0d-35ae-0f0e-8a6ffb2fc31b\",\n \"type\": \"string\",\n \"create\": true,\n \"list\": false,\n \"read\": true,\n \"update\": true,\n \"delete\": false,\n \"links\": {\n \"self\": \"https://gqe.lkmsyZhENSF5pcz50a0t06JMSDN.0rkiBDw2eVVVGIAs,Tem\"\n },\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244Z\"\n }\n },\n \"relationships\": {\n \"custom_api\": {\n \"data\": {\n \"id\": \"652e39d8-d613-493e-8c20-fef99ad6327a\",\n \"type\": \"string\"\n }\n },\n \"role\": {\n \"data\": {\n \"id\": \"it-developer\",\n \"type\": \"string\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea963740-6b01-485d-9c51-0fcf87f8964d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": false,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21739845-fe39-4318-b497-0a12360e00a5", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": false,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72a5dee8-1a9b-48e1-9c01-3f8f8945616e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom_api_role_policy\",\n \"create\": false,\n \"list\": false,\n \"read\": false,\n \"update\": false,\n \"delete\": false\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "84c6a3ff-fd4f-4aa4-8018-70c2d50af66a", "name": "Delete a Custom API Role Policy", "request": { "name": "Delete a Custom API Role Policy", "description": { "content": "Delete A Custom API Role Policy", "type": "text/plain" }, "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id", "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "bc84ca21-8992-4ffc-b37c-0fa15ce6a40c", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "26e53791-83fc-4ba3-88fe-e182c22b9b82", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"The field 'name' is required.\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efc2f161-8b2a-40ae-9d36-7f54ab3c0cd1", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Not found\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "367439f8-8ac3-408d-b938-2fa9f0de441d", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "permissions", "custom-api-role-policies", ":custom-api-role-policy-id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the Custom API Role Policy.", "type": "text/plain" }, "type": "any", "value": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "key": "custom-api-role-policy-id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Products", "description": "```mdx-code-block\nimport ProductsOverview from '/docs/partials/pxm/products/productsoverview.mdx';\nimport ProductTypes from '/docs/partials/pxm/products/types.mdx';\nimport ProductTags from '/docs/partials/pxm/products/tags.mdx';\nimport PersonalProducts from '/docs/partials/pxm/products/personalizing.mdx';\nimport ProductCatalogs from '/docs/partials/pxm/products/catalogs.mdx';\nimport Overview from \"/docs/partials/pxm/bundles/bundles.mdx\";\nimport ComponentOptions from \"/docs/partials/pxm/bundles/components.mdx\";\nimport BundlePricing from \"/docs/partials/pxm/bundles/bundlepricing.mdx\";\nimport DynamicBundles from \"/docs/partials/pxm/bundles/dynamic.mdx\";\nimport BundlesBundles from \"/docs/partials/pxm/bundles/bundlesof.mdx\";\n\n\n\n### Product Types\n\n\n\n### Personalizing Products\n\n\n\n### Products and Catalog Releases\n\n\n\n### Bundles\n\n\n\n### Bundle Components and Options\n\n\n\n### Bundle Pricing\n\n\n\n### Dynamic Bundles\n\n\n\n#### Creating Dynamic Bundles: An Overview\n\nThe following steps are an overview of how to use dynamic bundles.\n\n1. Create your products using [**create a product**](/docs/api/pxm/products/create-product).\n1. Create a bundle using [**create a bundle**](/docs/api/pxm/products/create-product).\n1. Specify minimum and/or maximum values for the number of product options that can be selected within the bundle. For example, if you want the shopper to select exactly 4 out of 10 options, set both the minimum and maximum values to 4 for each of the 10 product options.\n1. For each product option in the bundle, specify if it is a default option by adding `\"default\": true` to the product options that you want to be pre-selected for the shopper.\n1. Publish the bundle to your catalog using the [Publish a catalog](/docs/api/pxm/catalog/publish-release) endpoint so you can display the products to your shoppers in your storefront.\n1. When a shopper interacts with the bundle on your storefront, they can select the products they want from the list of options. Use the [configure a shopper bundle](/docs/api/pxm/catalog/configure-by-context-product) endpoint to capture the shoppers selections. This updates the `bundle_configuration` with the product options chosen by a shopper.\n1. Once a shopper has configured their bundle, use the add a product to a cart endpoint to add the selected bundle to the shopper’s cart.\n1. When the shopper proceeds to checkout, the selected product options from the bundle are included in the order.\n\n### Bundles of Bundles\n\n\n\n#### Creating Bundles of Bundles: An Overview\n\nTo create a bundle of bundles, simply add a bundle as a component to another bundle.\n\n1. Create your products using [**create a product**](/docs/api/pxm/products/create-product).\n1. Create all your child bundles using [**create a bundle**](/docs/api/pxm/products/create-product).\n1. [**Create a parent bundle**](/docs/api/pxm/products/create-product) and specify the product ID of your child bundle as an option of a component in your bundle. You cannot have more than 1500 options in a bundle.\n```\n", "item": [ { "id": "919843eb-40a2-4ccf-a84e-24416c960ddd", "name": "Create a product or bundle", "request": { "name": "Create a product or bundle", "description": { "content": "Creates a product or bundle with the attributes that are defined in the body.\n\n#### Product Types\n\nProduct Experience Manager automatically assigns types to the products you create. You can filter on product types. Product types can also be used in catalogs. For example, in your catalog, you can filter on `parent` so that only your parent products are displayed in your storefront. \n\nSee [**Product Types**](/docs/api/pxm/products/products#product-types).\n\n#### Product Tags\n\nYou can use product tags to store or assign a key word against a product or service that you sell in your store. The product tag can then be used to describe or label that product. Product tags represent similarities between products who do not share the same attributes. Using product tags means that you can group your products together, for example, by brand, category, subcategory, colors, types, industries, and so on. \n\nSee [**Product Tags**](/docs/api/pxm/products/product-tags).\n\n#### Personalizing Products\n\nYou can allow your shoppers to add custom text to a product when adding product items to their carts. This is useful, for example, if you have a product like a T-shirt that can be personalized, or you sell greetings cards that can be printed with your shoppers personalized messages. You can do this by configuring the `custom_inputs` attribute.\n\nWhen configuring the `custom_inputs` attribute:\n\n- You can rename `input` to something more representative of the input that shoppers are adding, for example, `message` or `front`.\n- `name` is the name that is displayed in your storefront.\n- You can add validation rules. For example, the input field must be a `string` and/or up to 255 characters in length. The limit is 255 characters.\n- You can specify if the input field is required.\n\n#### Curating Products\n\nYou can curate the products in a node. Product curation allows you to promote specific products within each node of your hierarchies, enabling you to create unique product collections in your storefront. For example, you may find you have an abundance of cotton T-Shirts and you want to promote these products to the top of the product list. When a shopper navigates to T-shirts, the cotton T-Shirts are displayed first. See [**Update a node**](/docs/api/pxm/products/update-node).\n\n#### Bundles\n\nWith Product Experience Manager, you can use the products API to create and manage bundles. A bundle is a purchasable product, consisting of one or more products that you want to sell together. \n\nSee [**Bundles**](/docs/api/pxm/products/products#bundles).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"attributes\": {\n \"external_ref\": \"d0ddf10c-402c-4e0f-b421-94e7f682c603\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"description\": \"T-shirt.\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\",\n \"mpn\": \"1234-5678-TTTT\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"custom_inputs\": {\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"T_Shirt\",\n \"description\": \"T-Shirt.\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "038ab6cd-10f3-4f14-bc38-8271d212439d", "name": "Creates a product with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"attributes\": {\n \"external_ref\": \"d0ddf10c-402c-4e0f-b421-94e7f682c603\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"description\": \"T-shirt.\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\",\n \"mpn\": \"1234-5678-TTTT\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"custom_inputs\": {\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"T_Shirt\",\n \"description\": \"T-Shirt.\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"custom_inputs\": {\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"description\": \"T-shirt.\",\n \"external_ref\": \"d0ddf10c-402c-4e0f-b421-94e7f682c603\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"T-Shirt\",\n \"description\": \"T-Shirt.\"\n }\n },\n \"mpn\": \"1234-5678-TTTT\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"status\": \"live\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/children\"\n }\n },\n \"component_products\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/component_products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/files\"\n }\n },\n \"main_image\": {\n \"data\": null\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/templates\"\n }\n },\n \"variations\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/variations\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2022-08-18T14:25:57.391Z\",\n \"owner\": \"store\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2022-08-18T14:25:57.391Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4ac69c2-844c-485e-9357-4a3ce0a8e55a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"attributes\": {\n \"external_ref\": \"d0ddf10c-402c-4e0f-b421-94e7f682c603\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"description\": \"T-shirt.\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\",\n \"mpn\": \"1234-5678-TTTT\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"custom_inputs\": {\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"T_Shirt\",\n \"description\": \"T-Shirt.\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5df3bf1-3de3-4f9b-8525-4a03a1c7befe", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"attributes\": {\n \"external_ref\": \"d0ddf10c-402c-4e0f-b421-94e7f682c603\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"description\": \"T-shirt.\",\n \"status\": \"live\",\n \"commodity_type\": \"physical\",\n \"mpn\": \"1234-5678-TTTT\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"custom_inputs\": {\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"T_Shirt\",\n \"description\": \"T-Shirt.\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a4558ba4-2063-44e1-90fb-7e2703a077f1", "name": "Get all products", "request": { "name": "Get all products", "description": { "content": "Retrieves a list of all your products in the Product Experience Manager system.\n\nYou can also use `include` to retrieve top-level resources, such as files or images, and key attribute data, such as SKU or slug for component products in a product bundle. With this option, you can get more information about the products in a product bundle in your store front, improving the buying experience for your shoppers.\n\n#### Pagination\n\nThis endpoint supports offset-based pagination using `page[offset]` and `page[limit]` query parameters.\n\n:::caution Planned pagination changes — on or after 1 June 2026\n\nThe pagination links returned by this endpoint currently differ from the Elastic Path Commerce Cloud platform standard. Specifically, the `current` link is not returned, `first`/`last` are not always present, `prev` is incorrectly omitted on the second page, and `next` is incorrectly omitted on the second-to-last page.\n\nOn or after **1 June 2026**, this endpoint will be updated so that `current` and `first` are always present, `last` is present on every page except the final page, `next` is present on every page except the last, and `prev` is present on every page except the first. See the [links](/docs/api/pxm/products/get-all-products#links) schema for full details.\n\nIf your integration iterates through pages using these links, please verify that it will handle the updated behaviour correctly before this date.\n\n:::\n\n#### Filtering\n\n Many Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\n The following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------- |\n| `eq` | `id`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `templates`, `commodity_type`, `owner`, `product_types`, `parent_id`, `tags`, `status`, `has_nodes (false only)`, `created_at`, `updated_at`, `external_ref`, `description` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. **Note:** `has_nodes` can only be filtered as `false`. | `?filter=eq(name,some-name)` |\n| `like` | `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `tags`, `description`, `external_ref` | Like. Checks if the operand contains the specified string. Wildcards are supported. | `?filter=like(name,*some-name*)` |\n| `in` | `id`, `name`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `product_types`, `parent_id`, `tags`, `external_ref` | Checks if the values are included in the specified list. If they are, the condition is true. For `product_types`, you can specify more than one product type. | `?filter=in(id,some-id)` |\n| `gt` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than. Checks if the value of the field is greater than the given value. | `?filter=gt(updated_at,2024-01-01T00:00:00Z)` |\n| `ge` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than or equal to. Checks if the value of the field is greater than or equal to the given value. | `?filter=ge(created_at,2023-01-01T00:00:00Z)` |\n| `lt` | `id`, `created_at`, `updated_at`, `external_ref` | Less than. Checks if the value of the field is less than the given value. | `?filter=lt(updated_at,2025-01-01T00:00:00Z)` |\n| `le` | `id`, `created_at`, `updated_at`, `external_ref` | Less than or equal to. Checks if the value of the field is less than or equal to the given value. | `?filter=le(created_at,2022-01-01T00:00:00Z)` |\n| `eq` (extensions) | `extensions.book.isbn` | Filters using a nested extension field. | `?filter=eq(extensions.book.isbn,1765426)` |\n| `eq` (shopper_attributes) | `shopper_attributes.color` | Filters using a shopper custom attribute field. | `?filter=eq(shopper_attributes.color,red)` |\n| `eq` (admin_attributes) | `admin_attributes.warehouse` | Filters using an admin custom attribute field. | `?filter=eq(admin_attributes.warehouse,US-EAST)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "64a38420-ee23-445a-a2b6-fa21b59e5d36", "name": "Returns a list of all products.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"custom_inputs\": {\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"description\": \"T-shirt.\",\n \"mpn\": \"1234-5678-TTTT\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"status\": \"live\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"extensions\": {\n \"products(size)\": {\n \"widthMM\": 600,\n \"fuelType\": \"electric\",\n \"hasUKPlug\": true,\n \"online\": null\n }\n }\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/children\"\n }\n },\n \"component_products\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/component_products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/files\"\n }\n },\n \"main_image\": {\n \"data\": null\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/templates\"\n }\n },\n \"variations\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/variations\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2022-08-18T14:25:57.391Z\",\n \"owner\": \"store\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2022-08-18T14:25:57.391Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c14382fc-73ca-4d88-95f1-8e68cef3f551", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2744fb1d-9489-4670-8eed-daa0076e5583", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n\nFor more information about the attributes and operators that are supported, see [Get all products](/docs/api/pxm/products/get-all-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" }, { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c45a6877-74a0-4b0d-92c3-7152edff9129", "name": "Get a product", "request": { "name": "Get a product", "description": { "content": "Returns a product by its identifier. \n\nYou can also use `include=component_products` to retrieve top-level resources, such as files or images, and key attribute data, such as SKU or slug for component products in a product bundle. With this option, you can get more information about the products in a product bundle in your store front, improving the buying experience for your shoppers.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "36843378-aa6f-4e84-931f-b5ea46394da3", "name": "Returns a product by its identifier.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"description\": \"This electric model offers an induction heating element and convection oven.\",\n \"mpn\": \"BE-R-1111-aaaa-1a1a\",\n \"name\": \"BestEver Range, Model 1a1a\",\n \"sku\": \"BE-Range-1a1a\",\n \"slug\": \"bestever-range-1a1a\",\n \"status\": \"draft\",\n \"upc_ean\": \"111122223333\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"extensions\": {\n \"products(size)\": {\n \"widthMM\": 600,\n \"fuelType\": \"electric\",\n \"hasUKPlug\": true,\n \"online\": null\n }\n }\n },\n \"relationships\": {\n \"custom_relationships\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b/custom-relationships\",\n \"CRP_summer_session\": \"/products/f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b/custom-relationships/CRP_summer_session/products\",\n \"CRP_winter_session\": \"/products/f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b/custom-relationships/CRP_winter_session/products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b/relationships/files\"\n }\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/f5bd4e59-a95f-4bda-bfe6-0f34f47ac94b/relationships/templates\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2023-09-28T10:43:41.72Z\",\n \"owner\": \"organization\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2023-09-28T10:43:41.72Z\",\n \"variation_matrix\": {},\n \"custom_relationships\": [\n \"CRP_summer_session\",\n \"CRP_winter_session\"\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "792211e5-0673-4292-a544-ae5ee5fc60c9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e481c53b-5447-4eff-ab72-b153edcc9bb1", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "316bc442-0ecc-4190-bfce-921f61953c72", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Using the include parameter, you can retrieve top-level resources.\n\n- Files or main image. For example, `include=files,main_image`.\n- Component product data. For example, `include=component_products`.\n- Key attribute data, such as SKU or slug.\n", "type": "text/plain" }, "key": "include", "value": "main_image,main_image" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e80c90aa-694a-4153-98c0-4f5332fd9204", "name": "Update a product or bundle", "request": { "name": "Update a product or bundle", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the product or bundle is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f0381174-eb4b-4319-8b4b-336cf964f368", "name": "Updates a product with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"description\": \"The 30 inch version of this popular electric range.\",\n \"mpn\": \"BE-R-1111-aaaa-1a1a-30\",\n \"name\": \"UPDATED BestEver Range 30 inch, Model 1a1a-30\",\n \"sku\": \"BE-Range-1a1a-30\",\n \"slug\": \"bestever-range-1a1a-30\",\n \"status\": \"draft\",\n \"upc_ean\": \"111130303030\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"MISE À JOUR de la gamme BestEver 30 pouces, modèle 1a1a-30\",\n \"description\": \"La version 30 pouces de cette cuisinière électrique populaire\"\n }\n },\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"relationships\": {\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/60afe403-a191-455e-b771-c510c928a308/relationships/files\"\n }\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/60afe403-a191-455e-b771-c510c928a308/relationships/templates\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2023-09-28T10:43:41.72Z\",\n \"owner\": \"organization\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2023-09-28T10:43:41.72Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2a0e741-3ca5-40ab-8ab6-142171ea09df", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "776ed424-6aac-4b46-8681-119ca59ab136", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee4127a9-4290-435c-bcaa-82d898cb5c13", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3889eb4-c7aa-4f7b-8175-2df609890cdc", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76b3dfd8-c01c-4a24-8442-0af99308ee9e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product\",\n \"id\": \"60afe403-a191-455e-b771-c510c928a308\",\n \"attributes\": {\n \"name\": \"UPDATED BestEver Range, Model 1a1a\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f5a1aa5c-184f-4791-b876-0e702606d325", "name": "Delete a product", "request": { "name": "Delete a product", "description": { "content": "Deletes the specified product.\n\nYou cannot delete a product if it is part of a bundle. You must first delete the bundle before you delete the product.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "0f82eb4a-3599-4c92-8751-54fcd9ed27c6", "name": "Deletes the specified product.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5341105c-b1a2-4b6e-aec0-826d50667ef4", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e943d6f-8be1-4825-a412-5ea775c9aea5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae1af98e-b06a-4cf6-93e4-946b79d0133e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c00ed999-1635-4a9e-8a01-97dabcf76ea4", "name": "Attach multiple nodes", "request": { "name": "Attach multiple nodes", "description": { "content": "Assigns products to multiple hierarchies and their children nodes. You can apply a filter to search for the appropriate products to attach to a node. For general filtering syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n \n The following attributes and operators are supported.\n \n | Operator | Attribute | Description | Example |\n | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------- |\n | `eq` | `id`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `templates`, `commodity_type`, `owner`, `product_types`, `parent_id`, `tags`, `status`, `has_nodes (false only)`, `created_at`, `updated_at`, `external_ref`, `description` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. **Note:** `has_nodes` can only be filtered as `false`. | `?filter=eq(name,some-name)` |\n | `like` | `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `tags`, `description`, `external_ref` | Like. Checks if the operand contains the specified string. Wildcards are supported. | `?filter=like(name,*some-name*)` |\n | `in` | `id`, `name`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `product_types`, `parent_id`, `tags`, `external_ref` | Checks if the values are included in the specified list. If they are, the condition is true. For `product_types`, you can specify more than one product type. | `?filter=in(id,some-id)` |\n | `gt` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than. Checks if the value of the field is greater than the given value. | `?filter=gt(updated_at,2024-01-01T00:00:00Z)` |\n | `ge` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than or equal to. Checks if the value of the field is greater than or equal to the given value. | `?filter=ge(created_at,2023-01-01T00:00:00Z)` |\n | `lt` | `id`, `created_at`, `updated_at`, `external_ref` | Less than. Checks if the value of the field is less than the given value. | `?filter=lt(updated_at,2025-01-01T00:00:00Z)` |\n | `le` | `id`, `created_at`, `updated_at`, `external_ref` | Less than or equal to. Checks if the value of the field is less than or equal to the given value. | `?filter=le(created_at,2022-01-01T00:00:00Z)` |\n | `eq` (extensions) | `extensions.book.isbn` | Filters using a nested extension field. | `?filter=eq(extensions.book.isbn,1765426)` |\n | `eq` (shopper_attributes) | `shopper_attributes.color` | Filters using a shopper custom attribute field. | `?filter=eq(shopper_attributes.color,red)` |\n | `eq` (admin_attributes) | `admin_attributes.warehouse` | Filters using an admin custom attribute field. | `?filter=eq(admin_attributes.warehouse,US-EAST)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", "attach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "15002f43-2a64-4112-b6bc-b875dcd8da7a", "name": "This request assigns the products that you have selected to multiple hierarchies and their children nodes and returns the following.", "originalRequest": { "url": { "path": [ "pcm", "products", "attach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"nodes_attached\": 3,\n \"nodes_not_found\": []\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a6423ae-25e9-4c0e-ad9b-396331d6190b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "attach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faecb3e2-fb34-460a-be26-e824595539df", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "attach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd6cf6f4-ee1a-43d2-9476-90582911947c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", "attach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1907e9fd-b87d-42c7-b763-03193c0da22e", "name": "Detach multiple nodes", "request": { "name": "Detach multiple nodes", "description": { "content": "Dissociates products from multiple hierarchies and their children nodes. You can apply filters to search for the appropriate products to detach. For general filtering syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n \nThe following attributes and operators are supported.\n \n | Operator | Attribute | Description | Example |\n | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------- |\n | `eq` | `id`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `templates`, `commodity_type`, `owner`, `product_types`, `parent_id`, `tags`, `status`, `has_nodes (false only)`, `created_at`, `updated_at`, `external_ref`, `description` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. **Note:** `has_nodes` can only be filtered as `false`. | `?filter=eq(name,some-name)` |\n | `like` | `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `tags`, `description`, `external_ref` | Like. Checks if the operand contains the specified string. Wildcards are supported. | `?filter=like(name,*some-name*)` |\n | `in` | `id`, `name`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `product_types`, `parent_id`, `tags`, `external_ref` | Checks if the values are included in the specified list. If they are, the condition is true. For `product_types`, you can specify more than one product type. | `?filter=in(id,some-id)` |\n | `gt` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than. Checks if the value of the field is greater than the given value. | `?filter=gt(updated_at,2024-01-01T00:00:00Z)` |\n | `ge` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than or equal to. Checks if the value of the field is greater than or equal to the given value. | `?filter=ge(created_at,2023-01-01T00:00:00Z)` |\n | `lt` | `id`, `created_at`, `updated_at`, `external_ref` | Less than. Checks if the value of the field is less than the given value. | `?filter=lt(updated_at,2025-01-01T00:00:00Z)` |\n | `le` | `id`, `created_at`, `updated_at`, `external_ref` | Less than or equal to. Checks if the value of the field is less than or equal to the given value. | `?filter=le(created_at,2022-01-01T00:00:00Z)` |\n | `eq` (extensions) | `extensions.book.isbn` | Filters using a nested extension field. | `?filter=eq(extensions.book.isbn,1765426)` |\n | `eq` (shopper_attributes) | `shopper_attributes.color` | Filters using a shopper custom attribute field. | `?filter=eq(shopper_attributes.color,red)` |\n | `eq` (admin_attributes) | `admin_attributes.warehouse` | Filters using an admin custom attribute field. | `?filter=eq(admin_attributes.warehouse,US-EAST)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", "detach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1de95a40-921c-4d8c-97cd-aa96810711e9", "name": "The request dissociates the products that you have selected from multiple hierarchies and their children and returns the following.", "originalRequest": { "url": { "path": [ "pcm", "products", "detach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"nodes_detached\": 1,\n \"nodes_not_found\": []\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c595c9de-a260-463b-ad4e-a25feee3e1aa", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "detach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06c55d57-9fc1-4edd-bea5-dc79635951f7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "detach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ae5cf46-8447-40dd-a6d9-08d367fcb250", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", "detach_nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"filter\": \"eq(sku,book)\",\n \"node_ids\": [\n \"123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f75229cd-46e2-41ca-be62-c486cb106859", "name": "Get a product's nodes", "request": { "name": "Get a product's nodes", "description": { "content": "Returns the nodes associated with the product. Products must be in a `live` status.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c68ff720-6898-44a9-8205-774a2d818ead", "name": "Successfully returns the product's nodes.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"type\": \"node\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"attributes\": {\n \"description\": \"All Dress Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures habillées\",\n \"description\": \"Toutes les chaussures habillées\"\n }\n },\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:50:21.729Z\",\n \"owner\": \"store\",\n \"sort_order\": 3,\n \"updated_at\": \"2024-01-11T19:50:21.729Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 2 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9af22c2b-7440-4c16-adc8-6513a62fa63e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e99991e-23e5-45c9-b050-7230d0864669", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfb94d55-6526-4ef2-907e-3a34d0510e91", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product Tags", "description": "```mdx-code-block\nimport ProductTags from '/docs/partials/pxm/products/tags.mdx';\n\n\n```\n", "item": [ { "id": "df1c3483-dcda-4582-a0c5-77bf235b03ee", "name": "Get All Product Tags", "request": { "name": "Get All Product Tags", "description": { "content": "Retrieves all product tags for a store. A store can view the tags associated with the organization to which the store belongs. However, an organization can only view the tags associated with the organization.\n \n", "type": "text/plain" }, "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a4d8e093-accd-41d2-b7db-45cdd4cf0f22", "name": "Returns all the product tags.", "originalRequest": { "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"tag\",\n \"id\": \"a88aac35-54de-40c2-bb4b-f1c57624db27\",\n \"attributes\": {\n \"value\": \"shirts\"\n },\n \"meta\": {\n \"created_at\": \"2024-03-20T15:56:40.014Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-03-20T15:56:40.014Z\"\n }\n },\n {\n \"type\": \"tag\",\n \"id\": \"6782e020-fefd-431e-9dea-b59d249c2c5e\",\n \"attributes\": {\n \"value\": \"shoes\"\n },\n \"meta\": {\n \"created_at\": \"2024-03-20T15:56:40.014Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-03-20T15:56:40.014Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46c85d82-9de6-481f-8f6c-c9d5ab8d6aa8", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "012393d7-4cd0-4451-990a-39a96ecb3513", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcb374c3-d434-4937-beac-514b92c78ff9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5d8e93b-8fb1-450f-b356-326b6e49cf29", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "tags" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7440cc0a-511c-476a-808e-62caf1af4324", "name": "Get a Product Tag", "request": { "name": "Get a Product Tag", "description": { "content": "Retrieves a product tag for a store. A store can view the tags associated with the organization to which the store belongs. However, an organization can only view the tags associated with the organization.", "type": "text/plain" }, "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID", "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5f763a14-e477-4871-b7cb-4ca226181b4b", "name": "Returns a product tag with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"tag\",\n \"id\": \"9879a8f5-0da2-4be6-91f6-a0f09d1c77a9\",\n \"attributes\": {\n \"value\": \"tables\"\n },\n \"meta\": {\n \"created_at\": \"2024-03-20T18:37:43.398Z\",\n \"owner\": \"organization\",\n \"updated_at\": \"2024-03-20T18:37:43.398Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a39c31d-c630-4f51-83c5-64e46a4386b7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f423352e-7314-4a7f-97dc-145f199992dd", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8aea40e8-373f-4e6b-8852-5422f54a3102", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44fe1787-2ce6-4601-a1e1-235f9754f6f9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "tags", ":tagID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the tag.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "tagID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Extending Products with Templates", "description": "```mdx-code-block\nimport TemplatesOverview from '/docs/partials/pxm/templates/extendingproducts.mdx';\n\n\n```\n", "item": [ { "id": "dce1dff6-3417-4be8-9c51-f178b7959ab0", "name": "Create a product template relationship", "request": { "name": "Create a product template relationship", "description": { "content": "Retrieves all the templates that are associated with the specified product.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a2f0b733-ed76-4b12-98bb-b35de447fcb9", "name": "Returns a created product template relationship.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d251af71-19b9-488e-9c68-f3b333f36bb6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95766d2c-ebc6-4e25-be0e-a15764438b67", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa550674-64e0-477a-94b3-a46ede872a1d", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2893f00a-b5a6-4a37-b830-034f27930492", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb870f15-2ac1-4b4d-823f-493ba0b3d7a2", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f815975a-20e2-4a80-85ae-6e33c12f38d3", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ce1cc447-822e-4a1a-bfca-6b30e406638b", "name": "Get all product template relationships", "request": { "name": "Get all product template relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cfb26cc7-d7f9-4b0b-8257-0ed6099c8940", "name": "Returns all product template relationships.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4361c61c-253e-4830-8714-a210f8f78c4d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "109ae69d-3def-4ad5-9280-c4eef99b790f", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "934ea047-5053-4d49-b5f4-065ccf2328d2", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "743c21ab-549c-4735-8de7-262d1bdae89e", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "551a313a-2efb-49a0-a431-15870bafe77d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f7a161e-4fac-4336-9500-1ac81d8ce7d1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2d402664-47d2-4e45-b4f5-9774757e8ec7", "name": "Delete a product template relationship", "request": { "name": "Delete a product template relationship", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "55ff055e-d4e6-4648-ac86-56f91138947e", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "21561d0e-cdb1-4d95-8b73-08354bd10c4b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebd22dce-888b-434a-8529-837122f66803", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2f17431-5214-42bd-90a6-dc18ade0522f", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fccdda97-fc61-46c0-861a-943d3cad4cf9", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3dee536e-7a26-4c13-a163-036e944b2d6c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "389c73c3-38a6-4d3a-9299-e89be17217a5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "templates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"template\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"template\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Bundle Component Products Relationships", "description": "With Product Experience Manager, you can create and manage bundles. A bundle is a purchasable product, consisting of one or more products that you want to sell together.\n\nYou can create multiple components within a bundle. Each component must have at least one or more options. Each option is a product and a quantity.\n", "item": [ { "id": "5253f259-c747-4321-8e9b-226f39808387", "name": "Get Bundle Component Product Relationships", "request": { "name": "Get Bundle Component Product Relationships", "description": { "content": "Retrieves all the products included in the specified bundle product.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f950439f-66e7-421f-82f7-275a61b1e7ed", "name": "Returns all Component Products relationships.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"product\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6595323f-3707-4b04-baf3-7919ff79dd93", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec6c4abe-f8d2-468d-b46f-4788ece9a903", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "357f72ec-17ad-4b53-8b32-65b204d462ab", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e36c76b-bfe6-4f32-a051-be91eec6c420", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fbb0721-27e6-4407-ab0b-b7f17bcf7a82", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "206120a2-fd20-496c-888c-c1cba307f2fd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "component_products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Variations", "description": "```mdx-code-block\nimport VariationsOverview from '/docs/partials/pxm/variations/variationsoverview.mdx';\nimport VariationsReusability from '/docs/partials/pxm/variations/variationsreusability.mdx';\nimport ChildProducts from '/docs/partials/pxm/variations/childproducts.mdx';\nimport BuildChildren from '/docs/partials/pxm/variations/buildchildproducts.mdx';\nimport ProductModifiers from '/docs/partials/pxm/variations/productmodifiers.mdx';\nimport PriceModifiers from \"/docs/partials/pxm/variations/pricemodifiers.mdx\";\n\n\n\n### Reusability\n\n\n\n### Child Products\n\n\n\n### Building Child Products\n\n\n\n### Sorting the Order of Variations and Options\n\nThe `variation_matrix` object lists the variation IDs and variation option IDs and their corresponding product IDs that are generated when the variation and variation options are built with a product. The `variation_matrix` can then be added to your catalogs.\n\nThe order of the variations in the `variation_matrix` is the order of the variations in the array when the variations were linked to the product. For example, the first variation in the `variation_matrix` corresponds to the first variation in the array, and so on. You can use the `sort_order`attribute to sort the order of your variation and variation options in the `variation_matrix` object. The sort order value is visible when you add the variations and variation options to your catalogs. You can then use the `sort_order` value to program your storefront to display the variations and variation options in the order that you want.\n\nAdd the `sort_order` attribute to the body of your request and specify a `sort_order` value. A `sort_order` value must be a number. You can specify any numbers that you want.\n\n- 1, 2, 3, or 100, 90, 80, and so on.\n- Zero or negative numbers.\n\nYou can set `sort_order` to either `null` or omit it entirely from the request if you wish to remove an existing `sort_order` attribute.\n\n:::caution\n\n- Commerce does not sort variations and variation options. You must program your storefront to sort the variations and variation options in the order that you want.\n- You must rebuild your products for the sort order changes to take effect. See [**Build Child Products**](#build-child-products).\n\n:::\n\n### Product Modifiers\n\n\n\n### Price Modifiers\n\n\n```\n", "item": [ { "id": "a4a397ec-4613-4427-bce5-e587a69723cf", "name": "Build child products", "request": { "name": "Build child products", "description": { "content": "With product variations in Product Experience Manager, you can create product variations and different options for each variation and use both to create child products for a product. Each child product is a unique combination of options associated with the product. \n\nChild products inherit attributes from their parent products. When you make changes to the attributes of the parent products, you can rebuild your child products, ensuring that changes to the parent products are propagated to the child products.\n\nAlternatively, you can modify a child product independently, without impacting its parent product. For example, you may prefer the status of your child product to be `live`, while keeping the parent product's status as `draft`. When you directly update a child product, it becomes independent of its parent product. In other words, any subsequent changes made to the parent product are not automatically reflected in the child product when you rebuild the parent product and its child products. Once a child product is independent of its parent, you cannot recreate the association between the child product and its parent. You must delete the child product and rebuild the parent to recreate the child product.\n\nFollowing on from that, if you add the same flow to both a parent and child product, the child flow values are not affected by changes to the parent flow values in a rebuild.\n\n### Using Build Rules\n\nWhen building your child products, you can build all products related to a product. \n\nAlternatively, you can build a combination of child products associated with a product, based on build rules that you specify. This is useful, for example, if you have a variation option that you do not sell. This makes managing and building your child products quick and easy. You can do this using `build_rules`. `build_rules` are combinations of variation option IDs that you wish to include or exclude when building your child products.\n\n:::note\n\nYou do not need to configure any `build_rules` in the following scenarios:\n\n- Child products must be built with all variation options. Simply, use the `Create a product` or `Update a product` endpoints with no `build_rules` specified.\n- Child products must be built apart from all options for a specific variation. In this case, you must remove the variation and use the `Create a product` or `Update a product` endpoints with no `build_rules` specified. In other words, using our example, if none of the `size` options should be included, then remove the `size` variation.\n\n:::\n\nThe `build_rules` contain:\n\n- (Required) `default`: specifies the default behavior.\n- (Optional) `include`: specifies the option IDs to include when the child products are built. Each combination consists of a nested array of option IDs from one or more variations. Combinations of option IDs in the nested arrays must come from different variations. See [**Invalid Build Rules**](#invalid-build-rules).\n- (Optional) `exclude`: specifies the option IDs to exclude when the child products are built. Each combination consists of a nested array of option IDs from one or more variations. Combinations of option IDs in the nested arrays must come from different variations. See [**Invalid build rules**](#invalid-build-rules).\n\nWhen building child products, Commerce compares each combination of option IDs to these rules to determine how your child products should be built, depending on how you have configured the `build_rules`. It depends on your requirements how you configure your `build_rules`.\n\n#### Invalid Build Rules\n\nThe `build_rules` are invalid if both the option IDs come from the same variation. Combinations of option IDs in the nested arrays must come from different variations.\n\nIf Commerce cannot resolve the `build_rules` a `could not determine whether to include or exclude a child product due to ambiguous rules` error is returned. This error can occur, for example, if you have the same number of variation option IDs in both the `include` and `exclude` arrays and the variation option IDs match.\n\n### Building Child Products\n\nBuilding child products is an asynchronous operation. When you build child products, a job is created. The jobId of the job is displayed in the response. When the job is complete, the build child products operation is also complete. You can use the jobId to see the status of your job using the `Get a Job` endpoint.\n\nJobs are processed one at a time. You can continue to send build child product requests, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed. See Jobs.\n\nRe-building child products after adding or removing a new variation changes the total number of child products that you can generate from a parent product. When you rebuild the child products after updating variations associated with the parent product, all existing child products that belong to a parent product are deleted. New child products are created with new product IDs.\n\nIf you have any bundles that reference child products directly, then you must update the bundles with the new child product IDs.\n\nHowever, re-building child products after adding or removing an option does not change the existing product IDs.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "27de10aa-4060-474b-ad44-e8db22495bfb", "name": "Successfully started building child products", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"dcc9e0bb-526b-4207-9e52-081589cdb50e\",\n \"attributes\": {\n \"completed_at\": null,\n \"created_at\": \"2024-11-01T14:11:00.917Z\",\n \"started_at\": null,\n \"status\": \"pending\",\n \"type\": \"child-products\",\n \"updated_at\": \"2024-11-01T14:11:00.917Z\"\n },\n \"meta\": {\n \"x_request_id\": \"85609bc9-6f19-4831-919a-a5b43e662061\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e435855-6787-4852-b359-ba62ba028dd3", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2ab4d5b-2edd-4f5d-a3c2-60046e7d9bf5", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d610818-1fa7-48ff-9a32-e7b6634cd40d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51550808-c6c6-4002-b1d5-fe6120ea475e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "404b677e-e395-41d0-9017-7ae8fe2876a5", "name": "Get child products", "request": { "name": "Get child products", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "28c9105a-ff95-4e94-9c07-3a709eef7e7b", "name": "Returns a list of child products for the specified parent product ID.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"4d32b816-4397-4a71-b875-4e4ea3ce6745\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"name\": \"Jeans\",\n \"sku\": \"jeansRed\",\n \"slug\": \"jeansRed\",\n \"status\": \"live\"\n },\n \"relationships\": {\n \"base_product\": {\n \"data\": {\n \"type\": \"product\",\n \"id\": \"571e366f-17e6-4e51-8239-b3cc8ee1144d\"\n }\n },\n \"children\": {\n \"data\": []\n },\n \"component_products\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/4d32b816-4397-4a71-b875-4e4ea3ce6745/relationships/component_products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/4d32b816-4397-4a71-b875-4e4ea3ce6745/relationships/files\"\n }\n },\n \"main_image\": {\n \"data\": null\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/4d32b816-4397-4a71-b875-4e4ea3ce6745/relationships/templates\"\n }\n },\n \"variations\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/4d32b816-4397-4a71-b875-4e4ea3ce6745/relationships/variations\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-05T10:29:44.603Z\",\n \"owner\": \"store\",\n \"product_types\": [\n \"child\"\n ],\n \"updated_at\": \"2024-01-05T10:29:45.155Z\",\n \"variation_matrix\": {},\n \"child_variations\": [\n {\n \"id\": \"119b2b76-0014-4077-826e-ae80ff207393\",\n \"name\": \"Size\",\n \"options\": null,\n \"option\": {\n \"id\": \"fad253ad-4485-4b35-8e3b-b475ad28e78d\",\n \"name\": \"Medium\",\n \"description\": \"Medium\"\n }\n },\n {\n \"id\": \"10ceafef-7ac9-4352-9797-4825a1671482\",\n \"name\": \"Colour\",\n \"options\": null,\n \"option\": {\n \"id\": \"b8128e51-1b0a-4b16-9eda-bb783b17026b\",\n \"name\": \"Red\",\n \"description\": \"#EE2238\"\n }\n }\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1eb94722-e17a-458e-a476-5b8a23078cbf", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b3e1d49-ca49-42f1-a496-0874678b1e42", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "67f4d778-3a55-4695-82a6-e95156dba34e", "name": "Create a product variation relationship", "request": { "name": "Create a product variation relationship", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "bb9ba099-e834-4f17-82c6-f5358bc0ff78", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "fb3f4840-e5ff-46e3-9f44-a8b75323dffc", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89cb5efc-1f15-4b32-a428-286689e30222", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "887ed29b-d77b-47cb-a3ff-9d985879f053", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee1710e1-2710-42ed-ac8d-2a0270c86e96", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc1cd3f6-aac1-4e59-8b54-ef09314a5000", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b0bf61e-494c-4e2f-b063-8f8fe7cffb3a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f566b638-6292-44c5-9ec6-4223e2f7cb1d", "name": "Get all product variation relationships", "request": { "name": "Get all product variation relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "60e90037-0782-4dab-a636-9d739e947f6c", "name": "Returns all product variation relationships.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"product-variation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff71b699-9dab-4ba5-8d2b-aa4e816bfb03", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d96fa702-149f-402c-8ca6-a8bfc0aabc78", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13bee9d3-c100-4541-8477-e06f2cc62b0f", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e9d2af3-16a1-46d9-8990-537f0321f511", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "144dc555-5326-4278-a606-d8fd0ac692a6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9f59c70-b724-480e-91dd-9b3ad9335d0c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8f1b528d-0a54-43c3-a0bd-f5f69906d400", "name": "Replace a product variation relationship", "request": { "name": "Replace a product variation relationship", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a5997587-3a9c-47e8-8d03-e2b53bad66d0", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a01325ec-6231-44bb-aadc-7140490ef292", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4140dfd-01eb-4d5e-8404-1daff0f91cf5", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4669a00c-31a1-46ca-98d2-4972f8f56353", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34ddab09-30ac-4e86-aaf3-ab505e9ee6e6", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5391c5aa-0ec5-4ac5-b21c-6e28b6bdf2b5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "072acdec-0551-4aee-80d1-38525f0431d0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "756b959b-35bf-4a2d-8b47-7386a2c9a724", "name": "Delete a product variation relationships", "request": { "name": "Delete a product variation relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "999f0f20-a973-4991-88ac-dfec4105f47b", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "30fbdfd9-48ba-44fa-97da-eb4c9dc6ff30", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "440f174a-a1d2-418c-833b-7aa13b41d893", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f77a08cd-340a-43d8-b2bf-fdd44c3705df", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1999b55-1f13-481c-b892-dd815981671a", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a79fa060-b7df-4d71-8bf7-8005964a6d7a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32d582ba-9c28-4a4f-851d-739983d21f57", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"product-variation\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3392e353-cf61-423d-8c92-4f9d08d431e1", "name": "Create a variation", "request": { "name": "Create a variation", "description": {}, "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 10\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fb169197-3c1b-481f-84da-949e3c181823", "name": "Returns a created variation with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 10\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 10\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4610513e-48e7-41ed-a7bb-59536caedc41", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 10\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c224a04e-8442-4b1d-a2f7-b78c9daad2e8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 10\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e8940da1-6c1f-4e7d-a9d5-9283cb6d0d62", "name": "Get all variations", "request": { "name": "Get all variations", "description": {}, "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "45563f45-f7ae-409d-8b18-c3ceda3f437f", "name": "Returns all variations.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product-variation\",\n \"id\": \"c1ccccba-53e4-46b5-aed8-94f32823148a\",\n \"attributes\": {\n \"name\": \"Size\",\n \"sort_order\": 1\n },\n \"meta\": {\n \"options\": [\n {\n \"id\": \"057a50ba-1afb-4944-9637-bd9b568a9f39\",\n \"name\": \"Large\",\n \"description\": \"Large size\",\n \"sort_order\": 3,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n },\n {\n \"id\": \"fa191e68-9bba-49f9-8e12-056c4e8f50e2\",\n \"name\": \"Medium\",\n \"description\": \"Medium size\",\n \"sort_order\": 2,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n },\n {\n \"id\": \"112d1c5c-d149-453e-b208-89470968bacf\",\n \"name\": \"Small\",\n \"description\": \"Small size\",\n \"sort_order\": 1,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n ],\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n },\n {\n \"type\": \"product-variation\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"name\": \"Paint Color\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e37e3dc8-ebcb-42e1-a1fc-d73cc98c8e79", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d24c9919-4ad9-4f90-981b-476150fec658", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6ebbbc03-f6e0-4203-8330-15c957153dd6", "name": "Get a variation", "request": { "name": "Get a variation", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0ac953a9-2628-4777-9893-2d126886cc04", "name": "Returns the specified variation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 1\n },\n \"meta\": {\n \"options\": [\n {\n \"id\": \"3de2c96c-2a99-4ded-bcf8-eeba32c0c5be\",\n \"name\": \"Red\",\n \"description\": \"Red color\",\n \"sort_order\": 2,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n },\n {\n \"id\": \"31f2d09b-8a10-447a-b3ad-3358d07f818a\",\n \"name\": \"Blue\",\n \"description\": \"Blue color\",\n \"sort_order\": 1,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n ],\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d02a26d8-40c9-4d83-91c9-00e186352b7f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f9b2ea9-37fe-4c84-89ee-b7a3b7c32ea1", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5a632bf-3c06-4726-a785-f7274897cf14", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "810c76fa-1ef1-4819-a207-92e6e1a8628e", "name": "Update a variation", "request": { "name": "Update a variation", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the variation is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c666f0d1-593a-4ec8-a990-d939a3e57eee", "name": "Returns an updated variation with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 1\n },\n \"meta\": {\n \"options\": [\n {\n \"id\": \"3de2c96c-2a99-4ded-bcf8-eeba32c0c5be\",\n \"name\": \"Red\",\n \"description\": \"Red color\",\n \"sort_order\": 2,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n },\n {\n \"id\": \"31f2d09b-8a10-447a-b3ad-3358d07f818a\",\n \"name\": \"Blue\",\n \"description\": \"Blue color\",\n \"sort_order\": 1,\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n ],\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6cf9f9a-42e0-4bf7-8b7c-ab0772cb81cb", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be4230c8-2520-4cf2-b227-be2ece0e85bf", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e37e5c1-2d9f-47c9-944c-b35d8ae53624", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af075908-9974-4be2-a8c4-6c0e4d722af9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17a6788c-3a4e-4404-8632-aceb4ee7abab", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"type\": \"product-variation\",\n \"attributes\": {\n \"name\": \"Paint Color\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "192be231-4867-47f9-a36f-7f9421312584", "name": "Delete a variation and all it's associated options.", "request": { "name": "Delete a variation and all it's associated options.", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "e6b7228a-5af2-4713-b286-309d14b270f6", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "be9c0169-90b3-42cb-ba62-5b9a67fb83b2", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a21d50a7-99b4-40a9-801f-d96c8e7c82f5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cfb3549a-6e8d-4492-87c3-397a140e1de1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9d954982-dcfd-41c2-9329-4fe112cefa1d", "name": "Create a variation option", "request": { "name": "Create a variation option", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"attributes\": {\n \"name\": \"Blue\",\n \"sort_order\": 0,\n \"description\": \"Our most popular color\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "371fea98-3bca-4f4c-8c54-ce58a0ae6ac5", "name": "Successfully returns the created variation option.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"attributes\": {\n \"name\": \"Blue\",\n \"sort_order\": 0,\n \"description\": \"Our most popular color\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bb7fe19-55ef-4a5c-8d6d-b7c00e7872d2", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"attributes\": {\n \"name\": \"Blue\",\n \"sort_order\": 0,\n \"description\": \"Our most popular color\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e1d2c35-3780-4ad1-954a-a1a9a1502a39", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"attributes\": {\n \"name\": \"Blue\",\n \"sort_order\": 0,\n \"description\": \"Our most popular color\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bc9da4cc-7a8d-4b09-975f-3eb98c1bd67c", "name": "Get all variation options", "request": { "name": "Get all variation options", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ea690f80-2a41-4857-abb6-203711b86206", "name": "Successfully returns all variation options.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n },\n {\n \"type\": \"product-variation-option\",\n \"id\": \"fbe73839-58a2-41b4-aca6-cb0724668c97\",\n \"attributes\": {\n \"description\": \"Our second most popular color\",\n \"name\": \"Red\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02a4f3a6-0661-4644-92e1-7cc4ea977249", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1948cb0-f42e-4adc-82e0-3dbf1e40c7bb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9f5b8eb0-545d-47dd-9666-ceebafce9c5f", "name": "Get a variation option", "request": { "name": "Get a variation option", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7231a3b4-d1b8-499f-a4ad-cd3027a48930", "name": "Successfully returns the variation option.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee50e8c4-a0d7-4327-8178-8b7bd3813b44", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57ac99a0-6d21-4087-9754-9793cf2f50af", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04fc71e0-095f-4c12-bc60-960756d54436", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2b326cc-546e-4dec-8a8f-017b1779d16d", "name": "Update a variation option", "request": { "name": "Update a variation option", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0a28ac2e-9f19-4102-8a18-d50e0f0b07e2", "name": "Successfully returns the updated variation option", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n },\n \"meta\": {\n \"owner\": \"store\",\n \"created_at\": \"2024-01-25T11:25:38.001Z\",\n \"updated_at\": \"2024-01-25T11:25:38.001Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dffcf983-e1d8-4aa2-a6a1-bb5c7003a9ca", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f3ff4fa-8287-4cf7-809e-2c63bd803cdf", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c609dc8a-f829-44ff-b5bf-998dfcecdce6", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a259cc33-dd27-40d8-8a4c-472698a84a9e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46f00791-8aa2-4d75-a452-8723c5d635ab", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-option\",\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"attributes\": {\n \"description\": \"Our most popular color\",\n \"name\": \"Blue\",\n \"sort_order\": 0\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "786fcdf2-9025-4fa1-ac6c-374c3dcbe143", "name": "Delete a variation option", "request": { "name": "Delete a variation option", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "d215bd65-fab1-4105-a106-4ae2dae95327", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d281050f-ef6c-4015-8731-d7782bc5c80b", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9818a8bb-b63b-4fbf-bdb8-d1743389de80", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "317edfc4-e521-4974-8b9b-d238ab520b41", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "879c3d79-5503-4b2e-960f-4bfacf84d6d6", "name": "Create a modifier", "request": { "name": "Create a modifier", "description": { "content": "You can specify different modifiers for different options in a variation. When you build child products using options in variations, the properties of a child products depends on the modifier set for the options that are applied to the child product.\n \nThe table below describes the different types of modifiers.\n\n| Modifier | Data Type | Effect |\n| :--- | :--- | :--- |\n| `name_equals` | `string` | Overrides the name of the child product with the name specified by the modifier. |\n| `name_append` | `string` | Appends the string specified in the modifier to the name of the child product. |\n| `name_prepend` | `string` | Prepends the string specified in the modifier to the name of the child product. |\n| `description_equals` | `string` | Overrides the description of the child product. |\n| `description_append` | `string` | Appends the string specified in the modifier to the description of the child product. |\n| `description_prepend` | `string` | Prepends the string specified in the modifier to the product description of the child product. |\n| `commodity_type` | `string` | Sets the commodity type of the child product, such as `physical` or `digital`. |\n| `price` | `string` | Allows application of price modifiers (`price_increment`, `price_decrement`, and `price_equals`) to the child products. |\n| `price_increment` | `string` | Increases the price of the child product. |\n| `price_decrement` | `string` | Decreases the price of the child product. |\n| `price_equals` | `string` | Sets the price of a child product to the amount you specify. |\n| `slug_append` | `string` | Appends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the `slug-builder` modifier, you can use `{}` in the `seek` field, for example, `\"seek\": :{COLOR}\"`. |\n| `slug_prepend` | `string` | Prepends the string specified in the modifier to the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the `slug-builder` modifier, you can use `{}` in the `seek` field, for example, `\"seek\": :{COLOR}\"`. |\n| `slug_builder` | `string`| Sets a part of the slug of the child product. Can only contain A-Z, a-z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed. However, for the `slug-builder` modifier, you can use `{}` in the `seek` field, for example, `\"seek\": :{COLOR}\"`. |\n| `sku_equals` | `string` | Sets the SKU of the child product. |\n| `sku_append` | `string` | Appends the string specified in the modifier to the SKU of the child product. |\n| `sku_prepend` | `string` | Prepends the string specified in the modifier to the SKU of the child product. |\n| `sku_builder` | `string` | Sets a part of the SKU of the child product. |\n| `status` | `string` | Sets the status of the child product, such as `draft` or `live`. |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dabc8679-cda6-47eb-8481-ad499886e8b8", "name": "Successfully returns the created modifier", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"a510cddc-e946-4c22-9541-54626a7cf0ec\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12a5e812-849c-4c6b-97a9-2d4a3860b9ca", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "342f623d-0a92-4a2e-b8fb-769e00d763cb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1db719ab-dd09-4f94-865d-c91ffc019116", "name": "Get all modifiers", "request": { "name": "Get all modifiers", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8cf9ccba-2bfa-4630-acd3-6d51787cea51", "name": "Successfully returns all variation modifiers.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"newSku\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n {\n \"type\": \"product-variation-modifier\",\n \"id\": \"a510cddc-e946-4c22-9541-54626a7cf0ec\",\n \"attributes\": {\n \"seek\": \"{color}\",\n \"set\": \"red\",\n \"type\": \"slug_builder\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n {\n \"type\": \"product-variation-modifier\",\n \"id\": \"2f0cbb06-8880-4a75-bfc6-a20f0f73a997\",\n \"attributes\": {\n \"reference_name\": \"PriceEqual\",\n \"type\": \"price\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 3\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4152b59f-6e02-4824-ad77-be2a592a6da7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6fbd95d-301c-4c53-8314-1ed3c511aed3", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1c07e4a0-cbb6-4def-bc34-a729c80ab901", "name": "Get a modifier", "request": { "name": "Get a modifier", "description": {}, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID", "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9f46f869-8cfe-4c42-bb2b-4d46f13d0a9b", "name": "Returns the specified modifier.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"newSku\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7cf2e23f-e1be-41db-923d-c4415f407fd5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ace2d62-8416-4f6b-a5a4-c0c0d42854e1", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10562e7c-ec5f-4315-bbd1-505d9a380883", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ed39d425-8266-479e-9d99-00ff092a555f", "name": "Update a modifier", "request": { "name": "Update a modifier", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the modifier is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID", "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "313b3e5f-9c01-4c28-a0b6-e9b01c1b973c", "name": "Successfully returns the updated modifier.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"newSku\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b41859fe-f6c9-4171-b753-b6122d602a42", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d235206-8dcb-4b57-9ed5-6de239a89048", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f643e172-4adc-4a45-9de3-fb233ee45224", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aaf57025-c069-4b5e-bcd0-37c1a7863902", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bae85a9d-bc3d-4398-bc49-f2e8ca302fc0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-variation-modifier\",\n \"id\": \"68ec4892-9e4c-4154-a9fd-f5a9fb1f6878\",\n \"attributes\": {\n \"type\": \"sku_equals\",\n \"value\": \"anotherSku\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "04913ed9-103f-4454-9a34-9610f63c616f", "name": "Delete a modifier", "request": { "name": "Delete a modifier", "description": { "content": "You cannot delete a modifier if it is in use. Deleting a modifier in us returns a `422 Failed Validation` error.", "type": "text/plain" }, "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID", "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID", "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID", "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "6d4c6e18-fdce-4d40-84c3-d337b3f4db77", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "60a6bff6-edaf-48a6-bf9f-f9dfe1e19828", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bce34dde-0024-4efb-8a50-4a7703a88ca8", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7de2c11f-b536-4eb5-bdcd-97f2b8b96107", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "variations", ":variationID", "options", ":optionID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the variation.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "variationID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the option.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "optionID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the modifier.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product File Relationships", "description": "Products are the items or services that you might want to sell in your store. In Product Experience Manager, products can also have associated rich media assets, such as product images or a file containing additional product details.\n\nYou can do this using [Files API](/docs/api/pxm/files).\n\nOnce you have created your files, you associate files with your products using the [Create Product-File Relationships API](/docs/api/pxm/products/create-product-file-relationships).\n", "item": [ { "id": "c4de1150-35ce-4b1c-a81f-034c52e62a5e", "name": "Get all product file relationships", "request": { "name": "Get all product file relationships", "description": { "content": "Retrieves all files that are associated with the specified product.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9e18445b-50f0-4fe8-9109-42e42bbed3e0", "name": "Returns all product file relationships.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b85621ce-3a09-47a6-989b-1a0f3719d9d9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95b0e032-61ba-4d32-90a6-54590a05be2c", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2287bab-3872-4c59-92ca-841162a4fa91", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da407209-29c9-4256-bf1e-b777a0a9ee2d", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ed7c18d-2af9-46ed-b1dd-4320f8bd4a96", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "293e9c3b-e077-42fa-8788-f3b719eeb1ae", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c32a4381-f2ad-4a92-8010-c558e42038aa", "name": "Create a product file relationship", "request": { "name": "Create a product file relationship", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9586df9c-b7da-41a3-bc0a-f8792acea972", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "438f54d4-d626-4a89-a9c5-527eb06aeb69", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d21d2384-74be-414b-ad5a-a56883739e95", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64e5d7a0-f206-4ceb-a432-03427d609c25", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed6a0032-79b8-48ae-9a9d-57e405aeda4b", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5d4f4e6-a639-4a2d-91e7-8d2ae3e6e827", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0382fd98-2bf4-4a0f-88b8-6f1f5a9d7471", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "59856c69-5628-4360-b710-8ead8e280bbd", "name": "Replace a product file relationship", "request": { "name": "Replace a product file relationship", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0c73f781-3ab8-467c-afe8-19a831ee2458", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "28eb431c-10b0-4023-9630-973dafd81a92", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f95100c2-a6af-4163-803a-af4d54156878", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bf29bcc-1a4b-4b68-86ac-18eefc08421a", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d7bf918-7bf0-499a-af25-7131a94d549f", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "923a4cd7-29c9-483d-bf3c-767b64e5cf44", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da18c90e-9d52-44fc-aed6-941e8df1b9d5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "824dda5e-a137-42b5-afe0-fb42dfa71bd2", "name": "Delete a product file relationships", "request": { "name": "Delete a product file relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "24033191-e81a-48fe-8667-05119d44fd83", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dd31d285-3a30-4826-816a-53ee0c97c798", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80492efd-9478-4a12-9207-2e773793ca49", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdbf031e-0a8f-43df-b537-4e6162badc58", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a67d0f89-04d9-462c-9693-d8ec8c978451", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2d2c205-43df-407d-9b4b-9f1597442ed6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eedf4d61-2b13-4667-bf09-e20ae2c73873", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "files" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"43903bfa-5352-4a3d-9496-c9ab1229a175\",\n \"type\": \"file\"\n },\n {\n \"id\": \"50f56ce9-9381-43f6-8a52-5369a8b42e52\",\n \"type\": \"file\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product Image Relationships", "description": "Products are the items or services that you might want to sell in your store. In Product Experience Manager, products can also have associated rich media assets, such as product images or a file containing additional product details.\n\nYou can do this using [Files API](/docs/api/pxm/files).\n\nOnce you have created your files, you associate files with your products using the [Create Product Main Image Relationships API](/docs/api/pxm/products/create-product-main-image-relationships).\n", "item": [ { "id": "849d85cd-2e60-41f3-95c8-6fd8303ffcdb", "name": "Create main image relationships", "request": { "name": "Create main image relationships", "description": { "content": "Associates a main image with the specified product.", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e48c57f6-d9e2-4e23-86ae-fcccecadc4ba", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a4c1111f-3ef5-406d-87ca-ed008b370ad6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e976a4b-96e6-4112-b726-eb3184bb9b23", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa7146e4-f5c7-4f14-b3fd-e21c4bc5c784", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01891ac2-ccae-458d-ac39-cf63b03640b4", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0fe4678-08ef-4d6d-8240-9cab19ef8ab2", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59e4d66e-e0eb-4cde-b659-161fe6fcce16", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c7231a70-fb69-422c-946d-aa997a898cad", "name": "Get Main Image Relationships", "request": { "name": "Get Main Image Relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d26d9a90-ff86-4e07-bfd8-414200de2757", "name": "Returns all product variation relationships", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"file\",\n \"id\": \"file-1\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37e8a503-5cac-477e-9e35-0254138415e5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19c25a8d-eedb-43d2-bc9d-e40921a60458", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37e77d76-9e40-4952-8971-bfba9bb0ed53", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4138136-9a70-4a67-a08d-5ce0a593f8b8", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6fde25a-2930-4600-8535-4e68e15461ab", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6bff7869-a0ce-4b10-b6ae-6aec903a4936", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9852fe11-5a9f-4980-9f78-f1480d1ef5e5", "name": "Replace Main Image Relationships", "request": { "name": "Replace Main Image Relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6ccee486-4745-4c71-9ed9-ea4700db57c2", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8261f4c5-3329-425b-80f2-3f832335c7a6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbd7a448-60fb-47e0-8836-fe69a6009443", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f4f2036-0fd7-49b6-b985-8ea75a12bdf9", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb114e33-2904-45bd-b8fc-fd4315f45831", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39a66317-f81c-4152-890a-e52deaffbc51", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "515c1687-25c2-49a2-9df7-8ddc555705c7", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"file\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "acc1e204-ce44-4c21-9fb3-d2fbab0a2182", "name": "Delete Main Image Relationships", "request": { "name": "Delete Main Image Relationships", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "22ecbe58-cb4c-4184-863e-a59fc7997dbf", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0505526d-79b4-4fda-86ec-140986417528", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45b6ce58-1753-46ac-b498-699d48e6fbdd", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1da2b09a-a5de-4930-a3cf-4a701e0561b9", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecefbc13-02c7-4740-82fb-c54850b37a90", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a42a3353-72d7-41e5-a0f1-15f4d2311183", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10c49773-31a3-4f22-b0d4-918a93bac8d5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "relationships", "main_image" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product Import/Bulk Update", "description": "```mdx-code-block\nimport ProductImport from '/docs/partials/pxm/import/import.mdx';\n\n\n```\n\n#### Using Imported Main Image Files\n\nYou can use the main images that you have previously uploaded to Commerce and assign them to your products when importing products to Commerce. You can do this by adding a `main_image_id` header to your `.csv` file. The ID you provide in `main_image_id` is the ID of a file that has already been uploaded to Commerce using create a file.\n\n#### Importing Custom Data (Flows)\n\nYou can also create/update custom extension data in a `.csv` file by creating a header that includes the flow `ID` and the field `slug` in the following format: \n\ntemplate:*flowID*:*fieldSlug*.\n\nwhere:\n\n- `template` must be `template`.\n- `flowID` is the ID of the flow that contains the field whose data you want to create/update.\n- `fieldSlug` is the slug of the field whose data you want to create/update.\n\nIn the following example, for a flow with ID `82c10a02-1851-4992-8ecb-d44f2782d09b` and a field with the slug `condition`:\n\n- the header is `template:82c10a02-1851-4992-8ecb-d44f2782d09b:condition`.\n- the updated custom data is `as-new`.\n\n | name | slug | sku | status | template:82c10a02-1851-4992-8ecb-d44f2782d09b:condition |\n | :--- | :--- | :--- | :--- | :--- |\n | BestEver Range | bestever-range-1a1a-30 | BE-Range-1a1a-30 | draft | as-new |\n\n#### Characteristics of CSV Import Files\n\nProduct Import uses a [**Comma Separated Values (CSV)**](#characteristics-of-csv-import-files) file to import/update products, main image files, and custom extension data. \n\n- Each row in a `.csv` file represents a product you want to create/update. \n- Each file:\n - must not be larger than 50 megabytes. If a `.csv` file is larger than 50 megabytes, a `503 client read error` is displayed.\n - must not have more than 50,000 rows, including the header. If a CSV file exceeds 50,000 rows, an error is displayed, and the products are not imported.\n In other words, if you have a file with 50,000 rows that is larger than 50 megabytes, an error is displayed, and the products are not imported.\n- If you want to create/update more than 50,000 products or your `.csv` file is larger than 50 megabytes, you must have a separate `.csv` file and import each `.csv` file one at a time.\n- You can update existing products, including images, templates/flow fields, and entries. The entry in the `.csv` file must have a unique `id` and/or `external_ref` that matches the `id` and `external_ref` of the existing product you want to update. You may have both a unique `id` and `external_ref`, but you must have at least one.\n- You can add new products. For new products that you want to add, the entry in the `.csv` file must have an `external_ref` that does not match any existing products.\n\nThe following table describes the headers that are supported.\n\n| Header | Required | Description |\n|:---- |:---------|:--|\n| id | Optional | A unique product ID that is generated when you create the product. The `id` is used to look up products in the `.csv` file and matches them to the products in your storefront that you want to update. |\n| external_ref | Optional | A unique attribute associated with a product. This could be an external reference from a separate company system, for example. The maximum length is 2048 characters. |\n| name | Required | The name of a product. |\n| description | Required | A description for a product. You can include quotes in your product description, if you want to emphasize a word, for example. To do this, put quotes around the product description. For example, \"This product description describes my \"product\" and the product \"version\".\" |\n| slug | Required | A label for the product that is used in the URL paths. A slug can contain any combination of letters, numbers, periods, hyphens, and underscores. NO spaces or other characters are allowed. By default, the product name is used as the slug. |\n| status | Required | The status of a product, either `Draft` or `Live`. |\n| commodity_type | Required | The commodity type, either `physical` or `digital`. |\n| upc_ean | Optional | The universal product code or european article number of the product. |\n| mpn | Optional | The manufacturer part number of a product. |\n| sku | Optional | The unique stock keeping unit of the product. |\n| tags | Optional | The product tags used to store or assign a key word against a product. A product can have up to 20 product tags. A product tag can be up to 255 characters. See [**Product Tags**](/docs/api/pxm/products/product-tags).\n| main_image_id | Optional | Specifies a unique ID of a main image file for a product. You can include a `main_image_id` for your products for images that are already uploaded to Commerce. See [**Using Main Image Files**](#importing-custom-data-flows). |\n| `template::` | Optional | You can also specify custom extension data in the CSV by specifying the flow `ID` or `slug` and the field `name`. For example, `template::` format. See [**Importing Custom Data (Flows)**](#importing-custom-data-flows). |\n", "item": [ { "id": "e7b510bf-b941-4a84-bb92-e3c8e12b0644", "name": "Import Products", "request": { "name": "Import Products", "description": { "content": "\nYou can use the Product Import API to:\n\n- Add new products, including:\n\n - main image files. See [Importing Main Image Files](/docs/api/pxm/products/product-import-bulk-update#using-imported-main-image-files).\n - custom data. See [Importing custom data](/docs/api/pxm/products/product-import-bulk-update#importing-custom-data-flows).\n - Make bulk updates to existing products.\n\nYou cannot use product import to:\n\n- Delete existing products.\n- Import product bundles.\n\nThe Product Import API uses a Comma Separated Values (CSV) file to import products, main image files, custom extension data, and admin and shopper attributes. Each row in a .csv file represents a product you want to create/update. See an [example file](/assets/pim_product_import_example.csv).\n\nEach file can have 50,000 rows, including the header. If a CSV file exceeds 50,000 rows, an error is displayed, and the products are not imported. A CSV file must not be larger than 50 megabytes. If a CSV file is larger than 50 megabytes, a `503 client read` error is displayed.\n\nIf you want to create/update more than 50,000 products or your CSV file is larger than 50 megabytes, you must have a separate CSV file and import each CSV file one at a time.\n\nSee [**Characteristics of CSV Files**](/docs/api/pxm/products/product-import-bulk-update#characteristics-of-csv-import-files).\n\n## Custom Attributes in CSV\n\nYou can set custom attributes on products using CSV columns with the prefixes `shopper_attributes.` or `admin_attributes.` followed by the attribute key name. For example:\n\n- `shopper_attributes.color` sets the `color` key on `shopper_attributes`.\n- `admin_attributes.cost_of_goods` sets the `cost_of_goods` key on `admin_attributes`.\n\n**Partial updates:** When updating an existing product, only the attribute keys present as columns in the CSV are affected. Attribute keys not included as columns are left unchanged.\n\n**Removing an attribute key:** To explicitly delete an attribute key from an existing product, set the cell value to `__REMOVE_ATTRIBUTE__`. This special sentinel value instructs the importer to remove that key from the product's custom attributes. An empty cell value is treated as a literal empty string, not a deletion.\n\n**New products:** For new products being created via import, any column whose value is `__REMOVE_ATTRIBUTE__` is ignored (the key is not created).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", "import" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the locale to assist in parsing flow entry date values.\n\n- If a supported locale is provided, the system attempts to interpret dates using that locale's conventions. The import job fails if a date does not match one of the supported locale's formats.\n- If this parameter is omitted, or if the value provided is not on the supported list, the system proceeds using its default parsing logic. An unsupported locale is ignored and does not cause a failure.\n\n**Supported Locales and Date Formats:**\n\n**`en-US`**\n- `1/2/2006 15:04:05`\n- `01/02/2006 15:04:05`\n- `1/2/06 15:04`\n\n**`en-GB`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04`\n\n**`en-CA`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04` \n\nAdditional locales and date formats can be added upon request.\n (This can only be one of en-US,en-GB,en-CA)", "type": "text/plain" }, "key": "locale", "value": "en-US" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "The file you want to upload. Ensure that the file format is Comma Separated Values (CSV).", "type": "text/plain" }, "key": "file", "type": "file" } ] }, "auth": null }, "response": [ { "id": "9509c0af-8761-4cce-93b7-a91136d9cb60", "name": "Import started", "originalRequest": { "url": { "path": [ "pcm", "products", "import" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the locale to assist in parsing flow entry date values.\n\n- If a supported locale is provided, the system attempts to interpret dates using that locale's conventions. The import job fails if a date does not match one of the supported locale's formats.\n- If this parameter is omitted, or if the value provided is not on the supported list, the system proceeds using its default parsing logic. An unsupported locale is ignored and does not cause a failure.\n\n**Supported Locales and Date Formats:**\n\n**`en-US`**\n- `1/2/2006 15:04:05`\n- `01/02/2006 15:04:05`\n- `1/2/06 15:04`\n\n**`en-GB`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04`\n\n**`en-CA`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04` \n\nAdditional locales and date formats can be added upon request.\n (This can only be one of en-US,en-GB,en-CA)", "type": "text/plain" }, "key": "locale", "value": "en-US" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "The file you want to upload. Ensure that the file format is Comma Separated Values (CSV).", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"7e1b9ba1-c844-4556-9b16-4ae3f0988b0f\",\n \"attributes\": {\n \"completed_at\": null,\n \"created_at\": \"2024-01-05T15:27:23.161Z\",\n \"started_at\": null,\n \"status\": \"pending\",\n \"type\": \"product-import\",\n \"updated_at\": \"2024-01-05T15:27:23.161Z\"\n },\n \"meta\": {\n \"x_request_id\": \"fad8c5c0-9546-4e0c-b68e-8a2d809891e5\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f2c44e9-fc8f-4696-9309-88d5f46ec9f3", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "import" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the locale to assist in parsing flow entry date values.\n\n- If a supported locale is provided, the system attempts to interpret dates using that locale's conventions. The import job fails if a date does not match one of the supported locale's formats.\n- If this parameter is omitted, or if the value provided is not on the supported list, the system proceeds using its default parsing logic. An unsupported locale is ignored and does not cause a failure.\n\n**Supported Locales and Date Formats:**\n\n**`en-US`**\n- `1/2/2006 15:04:05`\n- `01/02/2006 15:04:05`\n- `1/2/06 15:04`\n\n**`en-GB`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04`\n\n**`en-CA`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04` \n\nAdditional locales and date formats can be added upon request.\n (This can only be one of en-US,en-GB,en-CA)", "type": "text/plain" }, "key": "locale", "value": "en-US" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "The file you want to upload. Ensure that the file format is Comma Separated Values (CSV).", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce48be21-a8c8-4d08-b39a-ffcbaed74850", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "import" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the locale to assist in parsing flow entry date values.\n\n- If a supported locale is provided, the system attempts to interpret dates using that locale's conventions. The import job fails if a date does not match one of the supported locale's formats.\n- If this parameter is omitted, or if the value provided is not on the supported list, the system proceeds using its default parsing logic. An unsupported locale is ignored and does not cause a failure.\n\n**Supported Locales and Date Formats:**\n\n**`en-US`**\n- `1/2/2006 15:04:05`\n- `01/02/2006 15:04:05`\n- `1/2/06 15:04`\n\n**`en-GB`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04`\n\n**`en-CA`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04` \n\nAdditional locales and date formats can be added upon request.\n (This can only be one of en-US,en-GB,en-CA)", "type": "text/plain" }, "key": "locale", "value": "en-US" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "The file you want to upload. Ensure that the file format is Comma Separated Values (CSV).", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cae464a3-7710-4dd5-ac21-2b52d616d638", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", "import" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the locale to assist in parsing flow entry date values.\n\n- If a supported locale is provided, the system attempts to interpret dates using that locale's conventions. The import job fails if a date does not match one of the supported locale's formats.\n- If this parameter is omitted, or if the value provided is not on the supported list, the system proceeds using its default parsing logic. An unsupported locale is ignored and does not cause a failure.\n\n**Supported Locales and Date Formats:**\n\n**`en-US`**\n- `1/2/2006 15:04:05`\n- `01/02/2006 15:04:05`\n- `1/2/06 15:04`\n\n**`en-GB`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04`\n\n**`en-CA`**\n- `2/1/2006 15:04:05`\n- `02/01/2006 15:04:05`\n- `2/1/06 15:04` \n\nAdditional locales and date formats can be added upon request.\n (This can only be one of en-US,en-GB,en-CA)", "type": "text/plain" }, "key": "locale", "value": "en-US" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "The file you want to upload. Ensure that the file format is Comma Separated Values (CSV).", "type": "text/plain" }, "key": "file", "type": "file" } ] } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product Export", "description": "```mdx-code-block\nimport ProductExport from '/docs/partials/pxm/import/export.mdx';\n\n\n```\n\n### Characteristics of Exporting Products\n\n- Product exports are an asynchronous operation. When you send a request to the Export API, it triggers an asynchronous job to build the `.csv` file containing the product entries.\n- Jobs are processed one at a time. You can continue to send product export requests, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed. See [**Jobs**](/docs/api/pxm/products/jobs).\n- The Export API response includes a job resource. In the response, you can verify the job status; if the status is successful, the response includes a link to the location where the `.csv` file is stored. See [**Product Export CSV File**](#product-export-csv-file). A single CSV file contains 10,000 rows, excluding the header. If you are exporting 50,000 products, the job endpoint response contains links to five `.csv` files; each `.csv` file including 10,000 products.\n- You might have specified custom extension data in a `.csv` file when you imported the products. These modifications are all exported. So, when you send a request to the Export API, the `.csv` file, included in the Job endpoint response, reflects any changes that you have made.\n- You cannot export product bundles.\n\n### Product Export CSV File\n\nThe Product Export API generates a Comma Separated Values (CSV) file that you can use to import/update products, main image files, and custom extension data. \n\nThe `.csv` file is:\n\n - Comma-separated.\n - Header-based.\n - Header attributes must be the same as the product attributes.\n - Header names can be in any order.\n - Each row after the first line represents a single product.\n\nThe following table describes the headers that are supported.\n\n| Header | Required | Description | \n|:---------------------------------|:---------|:-----------------------------------------------------|\n| id | Optional | A unique product ID that is generated when you create the product. The `id` is used to look up products in the `.csv` file and matches them to the products in your storefront that you want to update. |\n| external_ref | Optional | A unique attribute associated with a product. This could be an external reference from a separate company system, for example. The maximum length is 2048 characters. | \n| name | Required | The name of a product. | \n| description | Required | A description for a product. You can include quotes in your product description, if you want to emphasize a word, for example. To do this, put quotes around the product description. For example, \"This product description describes my \"product\" and the product \"version\".\" |\n| slug | Required | A label for the product that is used in the URL paths. A slug can contain any combination of letters, numbers, periods, hyphens, and underscores. NO spaces or other characters are allowed. By default, the product name is used as the slug. |\n| status | Required | The status of a product, either `Draft` or `Live`. | \n| commodity_type | Required | The commodity type, either `physical` or `digital`. | \n| upc_ean | Optional | The universal product code or european article number of the product. | \n| mpn | Optional | The manufacturer part number of a product. | \n| sku | Optional | The unique stock keeping unit of the product. | \n| tags | Optional | The product tags used to store or assign a key word against a product. A product can have up to 20 product tags. A product tag can be up to 255 characters. See [**Product Tags**](/docs/api/pxm/products/product-tags\n). |\n| main_image_id | Optional | Specifies a unique ID of a main image file for a product. See [Exporting Main Image Files](#exporting-main-image-files). | \n| `_created_at` | Optional| The date and time a product was created. **Note**: This field does not populate any data; it is provided solely for informational purposes. | \n| `_updated_at` | Optional | The date and time a product was updated. **Note**: This field does not populate any data; it is provided solely for informational purposes. | \n| `template::created_at` | Optional | The date and time a template was created. **Note**: This field does not populate any data; it is provided solely for informational purposes. | \n| `template::updated_at` | Optional | The date and time a template was updated. **Note**: This field does not populate any data; it is provided solely for informational purposes. | \n| `template::` | Optional | Custom extension data includes the flow `ID` or `slug` and the field `name`. See [Exporting Custom Data (Flows)](#exporting-custom-data-flows). | \n\n### Exporting Main Image Files\n\nThe main images that you have previously uploaded Commerce are exported. A `main_image_id` header is added to your `.csv` file. The ID in `main_image_id` is the ID of a file that has already been uploaded to Commerce using [create a file](/docs/api/pxm/files/create-a-file).\n\n### Exporting Custom Data (Flows)\n\nCustom extension data is exported in a `.csv` file by creating a header that includes the flow `ID` or `slug` and the field `name` as shown below:\n\n- `template::`\n- `template::`\n\nwhere:\n\n- `template` must be `template`.\n- one of the following for the template that contains the field whose data you want to export:\n - `flowID` is the ID of the flow.\n - `flowSlug` is the flow slug.\n- `fieldName` is the name of the field whose data you want to export.\n\nIn the following example, for a flow with ID `82c10a02-1851-4992-8ecb-d44f2782d09b` and a field with the name `condition`:\n\n- the header is `template:82c10a02-1851-4992-8ecb-d44f2782d09b:condition`.\n- the updated custom data is `as-new`.\n\n| name | slug | sku | status | template:82c10a02-1851-4992-8ecb-d44f2782d09b:condition |\n| :--- | :--- | :--- | :--- | :--- |\n| BestEver Range | bestever-range-1a1a-30 | BE-Range-1a1a-30 | draft | as-new |\n", "item": [ { "id": "f0e2245d-ca81-4ae9-ac0e-b5f80c1f2c60", "name": "Export Products", "request": { "name": "Export Products", "description": { "content": "\nThe Export API is available to make bulk updates to products in Product Experience Manager. You might also export products for your personal requirements. \n \nThe Export API builds a CSV file containing the product entries. A CSV file can contain up to 50,000 product entries. If you have more than 50,000 product entries, then another CSV file is created and so on, until all your products are exported.\n\nThe Job endpoint response specifies the location where the CSV file is stored. See [Characteristics of CSV Files](/docs/api/pxm/products/product-export#characteristics-of-exporting-products).\n\n### Custom Attributes in Exported CSV\n\nExported CSV files include custom attribute columns using the prefixes `shopper_attributes.` and `admin_attributes.` followed by the attribute key name. For example, a product with `admin_attributes: {cost_of_goods: \"42.0\"}` produces a column `admin_attributes.cost_of_goods` in the exported file.\n\nYou can select specific attribute columns to include in the export using the `columns.include` parameter. You may specify individual keys (for example, `admin_attributes.cost_of_goods`) or use a wildcard to include all keys of a given type (for example, `admin_attributes.*`). You cannot combine a wildcard and individual keys for the same attribute type in a single export request.\n\n### Exporting Selected Columns\nProduct exports support the ability to select a subset of columns to be included in the generated .csv file. This allows you to export only the data you need, making it easier to work with smaller, more focused datasets.\n\n To specify the columns you want to include in the export, use the columns.include parameter in the request body of this endpoint. This parameter accepts an array of strings, where each string represents the name of a product attribute or a flow field.\n\n #### Specifying Flow Field Columns:\n \n The format for specifying flow field columns depends on the useTemplateSlugs setting:\n \n * useTemplateSlugs: `true`: Specify flow field columns using the format: `products():`. For example: `products(my_flow):my_field`.\n * useTemplateSlugs: `false` (default): Specify flow field columns using the format: `template::`. For example: `template:82c10a02-1851-4992-8ecb-d44f2782d09b:my_field`.\n \n #### Mandatory Fields:\n\n To ensure successful re-importing of product data, the following fields are always included in the export, regardless of the columns.include parameter:\n \n * id\n * name\n * sku\n * external_ref\n * commodity_type\n \n If the `columns.include` parameter is not provided in the request, the system will export all available product fields.\n \n ### Filtering\n \nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------- |\n | `eq` | `id`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `templates`, `commodity_type`, `owner`, `product_types`, `parent_id`, `tags`, `status`, `has_nodes (false only)`, `created_at`, `updated_at`, `external_ref`, `description` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. For `product_types`, you can only specify one product type. **Note:** `has_nodes` can only be filtered as `false`. | `?filter=eq(name,some-name)` |\n | `like` | `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `name`, `tags`, `description`, `external_ref` | Like. Checks if the operand contains the specified string. Wildcards are supported. | `?filter=like(name,*some-name*)` |\n | `in` | `id`, `name`, `sku`, `slug`, `upc_ean`, `manufacturer_part_num`, `product_types`, `parent_id`, `tags`, `external_ref` | Checks if the values are included in the specified list. If they are, the condition is true. For `product_types`, you can specify more than one product type. | `?filter=in(id,some-id)` |\n | `gt` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than. Checks if the value of the field is greater than the given value. | `?filter=gt(updated_at,2024-01-01T00:00:00Z)` |\n | `ge` | `id`, `created_at`, `updated_at`, `external_ref` | Greater than or equal to. Checks if the value of the field is greater than or equal to the given value. | `?filter=ge(created_at,2023-01-01T00:00:00Z)` |\n | `lt` | `id`, `created_at`, `updated_at`, `external_ref` | Less than. Checks if the value of the field is less than the given value. | `?filter=lt(updated_at,2025-01-01T00:00:00Z)` |\n | `le` | `id`, `created_at`, `updated_at`, `external_ref` | Less than or equal to. Checks if the value of the field is less than or equal to the given value. | `?filter=le(created_at,2022-01-01T00:00:00Z)` |\n | `eq` (extensions) | `extensions.book.isbn` | Filters using a nested extension field. | `?filter=eq(extensions.book.isbn,1765426)` |\n | `eq` (shopper_attributes) | `shopper_attributes.color` | Filters using a shopper custom attribute field. | `?filter=eq(shopper_attributes.color,red)` |\n | `eq` (admin_attributes) | `admin_attributes.warehouse` | Filters using an admin custom attribute field. | `?filter=eq(admin_attributes.warehouse,US-EAST)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Set to `true` if you want to use a template slug instead of a template ID when exporting products that have custom data.", "type": "text/plain" }, "key": "useTemplateSlugs", "value": "false" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-export\",\n \"attributes\": {\n \"columns\": {\n \"include\": [\n \"description\",\n \"template:a1b2c3d4-e5f6-7890-1234-567890abcdef:isbn\"\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dfb37835-a416-4a4a-a772-cc3eb169b884", "name": "Export started", "originalRequest": { "url": { "path": [ "pcm", "products", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Set to `true` if you want to use a template slug instead of a template ID when exporting products that have custom data.", "type": "text/plain" }, "key": "useTemplateSlugs", "value": "false" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-export\",\n \"attributes\": {\n \"columns\": {\n \"include\": [\n \"description\",\n \"template:a1b2c3d4-e5f6-7890-1234-567890abcdef:isbn\"\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"7e1b9ba1-c844-4556-9b16-4ae3f0988b0f\",\n \"attributes\": {\n \"completed_at\": null,\n \"created_at\": \"2024-01-05T15:27:23.161Z\",\n \"started_at\": null,\n \"status\": \"pending\",\n \"type\": \"product-export\",\n \"updated_at\": \"2024-01-05T15:27:23.161Z\"\n },\n \"meta\": {\n \"file_locations\": null,\n \"filter\": \"eq(sku,product-1)\",\n \"x_request_id\": \"fad8c5c0-9546-4e0c-b68e-8a2d809891e5\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9784cf64-e716-49bd-888a-96206882fdcc", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Set to `true` if you want to use a template slug instead of a template ID when exporting products that have custom data.", "type": "text/plain" }, "key": "useTemplateSlugs", "value": "false" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-export\",\n \"attributes\": {\n \"columns\": {\n \"include\": [\n \"description\",\n \"template:a1b2c3d4-e5f6-7890-1234-567890abcdef:isbn\"\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b311c4f-b051-4f6f-a9b7-ed3ef44cf5b7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Set to `true` if you want to use a template slug instead of a template ID when exporting products that have custom data.", "type": "text/plain" }, "key": "useTemplateSlugs", "value": "false" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-export\",\n \"attributes\": {\n \"columns\": {\n \"include\": [\n \"description\",\n \"template:a1b2c3d4-e5f6-7890-1234-567890abcdef:isbn\"\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0dcb73b7-9a5d-4786-bc3a-0e86ea6496e1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Set to `true` if you want to use a template slug instead of a template ID when exporting products that have custom data.", "type": "text/plain" }, "key": "useTemplateSlugs", "value": "false" }, { "disabled": false, "description": { "content": "\nMany Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.\n\nFor more information about the attributes and operators that this endpoint supports, see [Export Products](/docs/api/pxm/products/export-products).\n", "type": "text/plain" }, "key": "filter", "value": "filter=in(id,some-id)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-export\",\n \"attributes\": {\n \"columns\": {\n \"include\": [\n \"description\",\n \"template:a1b2c3d4-e5f6-7890-1234-567890abcdef:isbn\"\n ]\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Hierarchies", "description": "```mdx-code-block\nimport HierarchyOverview from '/docs/partials/pxm/hierarchies/hierarchies.mdx';\nimport HierarchyCatalog from '/docs/partials/pxm/hierarchies/hierarchycatalogs.mdx';\n\n\n\n## Creating Hierarchies and Nodes\n\nYou can create the **Major Appliances** hierarchy by performing the following steps.\n\n1. Using [**Create a Hierarchy**](/docs/api/pxm/products/create-hierarchy), create a hierarchy whose name is **Major Appliances**. Each hierarchy has a hierarchy ID. In other words, the hierarchy ID is the ID of the root node.\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the following child nodes. When you create a node in a hierarchy, by default, the node is a child of the root node. Specify `sort_order` to configure the order of the nodes.\n - **Ranges**\n - **Refrigerators**\n - **Dishwashers**\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the **Electric Ranges** node, specifying **Ranges** as the parent node.\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the following nodes, specifying **Electric Ranges** as the parent node.\n - **Electric Ranges 24ˮ**\n - **Electric Ranges 30ˮ**\n - **Double Oven**\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the **Gas Ranges** node, specifying **Ranges** as the parent node.\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the following nodes, specifying **Gas Ranges** as the parent node.\n - **Gas Ranges 24ˮ**\n - **Gas Ranges 30ˮ**\n - **Gas Ranges 32\"**\n - **Double Oven**\n1. Using [**Create a Node in a hierarchy**](/docs/api/pxm/products/create-node), create the following nodes, specifying **Dishwashers** as the parent node.\n - **Built-in**\n - **Standalone**\n\n## Hierarchies and Catalogs\n\n\n\n```\n", "item": [ { "id": "db3b6663-1240-4de0-9359-0ccdb50bc570", "name": "Create a hierarchy", "request": { "name": "Create a hierarchy", "description": { "content": "```mdx-code-block\nimport CASummary from '/docs/partials/pxm/custom-attributes/custom-attribute-spec-summary.mdx';\n\nCreates a hierarchy with a name, description, and slug to organize products in your catalog.\n\n\n```\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"Shoes\",\n \"description\": \"Shoes Category\",\n \"slug\": \"shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f9ce4791-9804-4f41-b784-a99b4cd01d6b", "name": "Returns a created hierarchy with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"Shoes\",\n \"description\": \"Shoes Category\",\n \"slug\": \"shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Shoes\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52c54125-c4b9-4e97-a797-d5504cffb2e1", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"Shoes\",\n \"description\": \"Shoes Category\",\n \"slug\": \"shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68153caf-1bfe-49fe-a8ec-db548f3cd993", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"Shoes\",\n \"description\": \"Shoes Category\",\n \"slug\": \"shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "060414e6-6c04-4f6d-8c4b-b6357191abfd", "name": "Get all hierarchies", "request": { "name": "Get all hierarchies", "description": { "content": "Get all hierarchies\n\n#### Pagination\n\nThis endpoint supports offset-based pagination using `page[offset]` and `page[limit]` query parameters.\n\n:::caution Planned pagination changes — on or after 1 June 2026\n\nThe pagination links returned by this endpoint currently differ from the Elastic Path Commerce Cloud platform standard. Specifically, the `current` link is not returned, `first`/`last` are not always present, `prev` is incorrectly omitted on the second page, and `next` is incorrectly omitted on the second-to-last page.\n\nOn or after **1 June 2026**, this endpoint will be updated so that `current` and `first` are always present, `last` is present on every page except the final page, `next` is present on every page except the last, and `prev` is present on every page except the first. See the [links](#links) schema for full details.\n\nIf your integration iterates through pages using these links, please verify that it will handle the updated behaviour correctly before this date.\n\n:::\n\n#### Filtering\n \nMany Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n|----------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|------------------------------------------|\n| `eq` | `id`, `hierarchy_id`, `owner`, `parent_id`, `name`, `slug`, `description`, `has_children`, `created_at`, `updated_at`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.id`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Equals. Checks if the value of the attribute matches the specified value. | `filter=eq(name,some-name)`, `filter=eq(locales.fr-FR.name,Nom-du-produit)` |\n| `in` | `id`, `hierarchy_id`, `parent_id`, `breadcrumbs.id` | Checks if the value of the attribute is included in the specified list. | `filter=in(id,1,2,3,4)` |\n| `lt`, `le`, `gt`, `ge` | `id`, `hierarchy_id`, `parent_id`, `created_at`, `updated_at` | Comparison operators. `lt`: Less than, `le`: Less than or equal to, `gt`: Greater than, `ge`: Greater than or equal to. | `filter=lt(id,100)`, `filter=ge(created_at,2022-01-01)` |\n| `like` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Like. Checks if the attribute contains the specified string (wildcards supported). | `filter=like(name,*some-name*)`, `filter=like(locales.es-ES.description,*descripción*)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "in(id,some-id)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "lt(id,100)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "le(created_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "gt(updated_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "ge(parent_id,500)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(locales.fr-FR.name,Nom-du-produit)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0496b627-b73a-44bf-85ba-d0b1ec50b447", "name": "Returns a list of all hierarchies.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n },\n \"name\": \"Shoes\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:30:50.867Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"links\": {\n \"last\": \"/pcm/hierarchies?page[offset]=29&page[limit]=1\",\n \"next\": \"/pcm/hierarchies?page[offset]=1&page[limit]=1\"\n },\n \"meta\": {\n \"results\": {\n \"total\": 30\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12eda3ef-bcfa-409b-8508-5f9eb008698e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69e8a170-3739-42c3-8ac8-6919694e55ac", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3833dafb-7e71-48a5-8c1d-d039ac32025d", "name": "List all nodes", "request": { "name": "List all nodes", "description": { "content": "A fully paginated view of all nodes in all hierarchies regardless of depth.\n\n#### Filtering\n\nMany Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n|----------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|------------------------------------------|\n| `eq` | `id`, `hierarchy_id`, `owner`, `parent_id`, `name`, `slug`, `description`, `has_children`, `created_at`, `updated_at`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.id`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Equals. Checks if the value of the attribute matches the specified value. | `filter=eq(name,some-name)`, `filter=eq(locales.fr-FR.name,Nom-du-produit)` |\n| `in` | `id`, `hierarchy_id`, `parent_id`, `breadcrumbs.id` | Checks if the value of the attribute is included in the specified list. | `filter=in(id,1,2,3,4)` |\n| `lt`, `le`, `gt`, `ge` | `id`, `hierarchy_id`, `parent_id`, `created_at`, `updated_at` | Comparison operators. `lt`: Less than, `le`: Less than or equal to, `gt`: Greater than, `ge`: Greater than or equal to. | `filter=lt(id,100)`, `filter=ge(created_at,2022-01-01)` |\n| `like` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Like. Checks if the attribute contains the specified string (wildcards supported). | `filter=like(name,*some-name*)`, `filter=like(locales.es-ES.description,*descripción*)` |\n| `ilike` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Case-insensitive like. Same as `like` but ignores case when matching. | `filter=ilike(name,*some-name*)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "in(id,some-id)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "lt(id,100)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "le(created_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "gt(updated_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "ge(parent_id,500)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(locales.fr-FR.name,Nom-du-produit)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "When true, includes hierarchy objects in the response alongside nodes", "type": "text/plain" }, "key": "include_hierarchies", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1852a9ce-daa3-4f2f-baaf-89f97ec7b638", "name": "Returns a list of nodes", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "When true, includes hierarchy objects in the response alongside nodes", "type": "text/plain" }, "key": "include_hierarchies", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"type\": \"node\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"attributes\": {\n \"description\": \"All Dress Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures habillées\",\n \"description\": \"Toutes les chaussures habillées\"\n }\n },\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:50:21.729Z\",\n \"owner\": \"store\",\n \"sort_order\": 3,\n \"updated_at\": \"2024-01-11T19:50:21.729Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 2 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n },\n \"name\": \"Shoes\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:30:50.867Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 3\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b9c947a-f97e-4428-b571-120234a86534", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "When true, includes hierarchy objects in the response alongside nodes", "type": "text/plain" }, "key": "include_hierarchies", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da03209a-86de-4bc4-9958-82b632c8984d", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "When true, includes hierarchy objects in the response alongside nodes", "type": "text/plain" }, "key": "include_hierarchies", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46d02b14-ca92-42c1-bd1c-d8b3775c40ab", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "When true, includes hierarchy objects in the response alongside nodes", "type": "text/plain" }, "key": "include_hierarchies", "value": "false" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bb1540d1-eb63-4cf3-bc0c-af2c3c199f1c", "name": "Get a hierarchy", "request": { "name": "Get a hierarchy", "description": { "content": "Retrieves the specified hierarchy.", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "323ec1e6-7dc9-4930-94d6-93ce1fbc9753", "name": "Returns a hierarchy with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures\",\n \"description\": \"Catégorie de chaussures\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Shoes\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2d29603-5a23-4192-97b8-7b6744001db7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43a73374-3e81-412c-92b9-8b781e9159ed", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2b3ef2d-9e4e-4fd2-a79c-c1c7ee7c3c65", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "038875ca-a72a-46c0-918c-7556ddc0743d", "name": "Update a hierarchy", "request": { "name": "Update a hierarchy", "description": { "content": "```mdx-code-block\nimport CASummary from '/docs/partials/pxm/custom-attributes/custom-attribute-spec-summary.mdx';\n\nUpdates a hierarchy. You can do a partial update, where you specify only the field value to change.\n\n\n```\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a9e7eeb8-5a88-48ef-bf9a-82d2cc4bab54", "name": "Successfully returns the updated hierarchy", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:30:50.867Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e53431bc-0a55-4a21-b068-ca89aae909d8", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51ca6e15-9d51-4f45-84e0-fddbec0d0cc7", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e43640cd-a230-4ba0-a4d5-9440e1edb25e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c55fa5a1-1455-4088-8ab1-71bdd7ab37ac", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "04ab92fe-26eb-471c-902f-24190ea245e5", "name": "Delete a hierarchy", "request": { "name": "Delete a hierarchy", "description": { "content": "Deletes the specified hierarchy and all its children.", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "56c88909-ff2d-4773-be9b-494a10a7758a", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d891e61d-0b6a-415f-b6b0-701d67c12d93", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80b728aa-c95c-416e-821c-0009d52b42dd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a9094fdd-d785-46fd-b7af-9a8c60d90a0a", "name": "Create a node", "request": { "name": "Create a node", "description": { "content": "```mdx-code-block\nimport CASummary from '/docs/partials/pxm/custom-attributes/custom-attribute-spec-summary.mdx';\n\nCreates a node in the specified hierarchy.\n\n \n```\n\n ### Sorting Nodes in a Hierarchy\n \n You can sort the order of your nodes, regardless of where the nodes are in the hierarchy.\n\n You can do this by adding a `meta` object to the body of your request and specifying a `sort_order` value.\n \n The node with the highest value of `sort_order` is displayed first. For example, a node with a `sort_order` value of `3` appears before a node with a `sort_order` value of `2`.\n\n - If you don’t provide `sort_order` when creating nodes, all child nodes in the response for Get a Node’s Children request are ordered by the `updated_at` time in descending order, with the most recently updated child node first.\n - If you set `sort_order` for only a few child nodes, the child nodes with a `sort_order` value appear first and then other child nodes appear in the order of `updated_at` time.\n\n You can also specify a `sort_order` when creating a node relationship.\n\n - If you create a node (**Node A**) with a `sort_order` and then you create a relationship for **Node A** with another node (**Node B**), the `sort_order` you specified when creating **Node A** is overwritten.\n - If you create **Node A** and then you create a relationship with **Node B** but do not configure a `sort_order`, the `sort_order` you specified when you created **Node A** is not overwritten.\n \n ### Curating Products in a Node\n \n You can curate the products in a node. Product curation allows you to promote specific products within each node of your hierarchies, enabling you to create unique product collections in your storefront. For example, you may find you have an abundance of cotton T-Shirts and you want to promote these products to the top of the product list. When a shopper navigates to T-shirts, the cotton T-Shirts are displayed first.\n \n You can do this by adding a `curated_products` attribute to the body of your request and adding an array of product IDs to the attribute. You should add the products IDs in the order you want them to be displayed in your node. The first product ID is displayed first in the product list.\n \n You can only curate 20 products or less. You cannot have more than 20 curated products.\n \n - The product IDs you provide must exist in the specified node.\n - If a curated product is removed from a node, the product is also removed from the curated_products list.\n - Once you have curated the products in a node, you can use the get node products endpoint to retrieve a list of curated products.\n \n You can then display your curated products in your catalogs using the following catalog endpoints.\n \n - Get a node in your latest catalog release.\n - Get a node in a catalog.\n - Get all nodes in your latest catalog release.\n - Get all nodes in a catalog.\n - Get node children in your latest catalog release.\n - Get node children in a catalog.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a045422a-5163-48ab-9e66-82c18f25757f", "name": "Successfully returns the created node", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"All Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"parent\": {\n \"data\": {\n \"type\": \"node\",\n \"id\": \"14e8e15a-7214-435d-bccb-6ae9b570d683\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"parent_name\": \"Shoes\",\n \"sort_order\": 2,\n \"updated_at\": \"2024-01-11T19:19:50.087Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6aa9ffc-93fd-4e36-875a-aef7a6c38131", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "031a39f3-60c5-4f54-8892-e6410b4b676c", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7640ae75-cf66-4783-936a-6c806d9ede28", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5179a604-e585-4bad-8043-f2eb49b3b051", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"All Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les ballerines\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 2\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b4dee65-ab45-4945-a1d9-0352cb48da31", "name": "Get all nodes in a hierarchy", "request": { "name": "Get all nodes in a hierarchy", "description": { "content": "A fully paginated view of all nodes in a hierarchy regardless of depth.\n\n#### Filtering\n\nMany Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n|----------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|------------------------------------------|\n| `eq` | `id`, `hierarchy_id`, `owner`, `parent_id`, `name`, `slug`, `description`, `has_children`, `created_at`, `updated_at`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.id`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Equals. Checks if the value of the attribute matches the specified value. | `filter=eq(name,some-name)`, `filter=eq(locales.fr-FR.name,Nom-du-produit)` |\n| `in` | `id`, `hierarchy_id`, `parent_id`, `breadcrumbs.id` | Checks if the value of the attribute is included in the specified list. | `filter=in(id,1,2,3,4)` |\n| `lt`, `le`, `gt`, `ge` | `id`, `hierarchy_id`, `parent_id`, `created_at`, `updated_at` | Comparison operators. `lt`: Less than, `le`: Less than or equal to, `gt`: Greater than, `ge`: Greater than or equal to. | `filter=lt(id,100)`, `filter=ge(created_at,2022-01-01)` |\n| `like` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Like. Checks if the attribute contains the specified string (wildcards supported). | `filter=like(name,*some-name*)`, `filter=like(locales.es-ES.description,*descripción*)` |\n| `ilike` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Case-insensitive like. Same as `like` but ignores case when matching. | `filter=ilike(name,*some-name*)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "in(id,some-id)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "lt(id,100)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "le(created_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "gt(updated_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "ge(parent_id,500)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(locales.fr-FR.name,Nom-du-produit)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d059ab47-bcfe-4e58-9573-021d48db63b0", "name": "Successfully returns the node's children", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"type\": \"node\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"attributes\": {\n \"description\": \"All Dress Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures habillées\",\n \"description\": \"Toutes les chaussures habillées\"\n }\n },\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:50:21.729Z\",\n \"owner\": \"store\",\n \"sort_order\": 3,\n \"updated_at\": \"2024-01-11T19:50:21.729Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 2 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db607129-e13a-4acd-8a04-79f06951ae1b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd7d592f-49ad-4df5-9e7c-bf34f8ab9997", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c7be164-769a-4989-b20e-5e0ce252c18c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "676d5ab0-5955-44c6-9add-7ffe99f4d599", "name": "Get a node", "request": { "name": "Get a node", "description": { "content": "Retrieves a node from a hierarchy.", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9db44dbd-081f-498b-844b-7ba88bdf2a0a", "name": "Returns a node with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"All Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Toutes les chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"parent\": {\n \"data\": {\n \"type\": \"node\",\n \"id\": \"14e8e15a-7214-435d-bccb-6ae9b570d683\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"parent_name\": \"Shoes\",\n \"sort_order\": 2,\n \"updated_at\": \"2024-01-11T19:19:50.087Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3883f16-c7b0-4d04-8d67-92e318b42257", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf33614d-c1c5-42c2-8a6f-43d6bb70a137", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b93b2228-4448-4a2f-a4d6-96c34f487e6b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "20b6485d-4de4-4e59-8d49-5f1b06a8fc46", "name": "Update a node", "request": { "name": "Update a node", "description": { "content": "```mdx-code-block\nimport CASummary from '/docs/partials/pxm/custom-attributes/custom-attribute-spec-summary.mdx';\n\nUpdates the specified node in a hierarchy. You can do a partial update, where you specify only the field value to change.\n\n \n```\n\n### Sorting Nodes in a Hierarchy\n\nYou can sort the order of your nodes, regardless of where the nodes are in the hierarchy.\n \n The node with the highest value of sort_order is displayed first. For example, a node with a `sort_order` value of `3` appears before a node with a `sort_order` value of `2`.\n \n - If you don’t provide `sort_order` when creating nodes, all child nodes in the response for Get a Node’s Children request are ordered by the `updated_at` time in descending order, with the most recently updated child node first.\n - If you set `sort_order` for only a few child nodes or not all, the child nodes with a `sort_order` value appear first and then other child nodes appear in the order of `updated_at` time.\n \n You can also specify a sort_order when creating a node relationship.\n\n - If you update a node (**Node A**) with a `sort_order` and then you create a relationship for **Node A** with another node (**Node B**), the `sort_order` you specified when updating **Node A** is overwritten.\n - If you have updated **Node A** and then you create a relationship with **Node B** but do not configure a `sort_order`, the `sort_order` you specified when you updated **Node A** is not overwritten.\n \n ### Curating Products in a Node\n\n You can curate the products in a node. Product curation allows you to promote specific products within each node of your hierarchies, enabling you to create unique product collections in your storefront. For example, you may find you have an abundance of cotton T-Shirts and you want to promote these products to the top of the product list. When a shopper navigates to T-shirts, the cotton T-Shirts are displayed first.\n\n You can do this by adding a `curated_products` attribute to the body of your request and adding an array of product IDs to the attribute. You should add the products IDs in the order you want them to be displayed in your node. The first product ID is displayed first in the product list.\n\n You can only curate 20 products or less. You cannot have more than 20 curated products.\n \n - The product IDs you provide must exist in the specified node.\n - If a curated product is removed from a node, the product is also removed from the curated_products list.\n - Once you have curated the products in a node, you can use the get node products endpoint to retrieve a list of curated products.\n \n You can then display your curated products in your catalogs using the following catalog endpoints.\n \n - [Get a node in your latest catalog release](/docs/api/pxm/catalog/get-node)\n - [Get a node in a catalog](/docs/api/pxm/catalog/get-by-context-node)\n - [Get all nodes in your latest catalog release](/docs/api/pxm/catalog/get-all-nodes)\n - [Get all nodes in a catalog](/docs/api/pxm/catalog/get-by-context-all-nodes)\n - [Get node children in your latest catalog release](/docs/api/pxm/catalog/get-child-nodes)\n - [Get node children in a catalog](/docs/api/pxm/catalog/get-by-context-child-nodes)\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "103950a5-86ec-4a23-8334-49c381a4bc0b", "name": "Successfully returns the updated node", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92721b34-297c-497a-a376-ba8c223ae4dc", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bf45a49-6914-4755-80d3-3a3197504f45", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ec97047-a41d-4c7c-9d29-8690e7a9a1ad", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d729d1a-014d-4a36-a2a2-4f8efc6095d4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"name\": \"Ballet Shoes\",\n \"description\": \"Latest Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": null\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": null,\n \"charge_type\": \"credit card\"\n },\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n }\n },\n \"meta\": {\n \"sort_order\": 5\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b35686d-73c5-4b99-9c8c-5da6eb363d28", "name": "Deletes a node", "request": { "name": "Deletes a node", "description": { "content": "Deletes a node by the node ID", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "76c4ee7e-6c8b-48a8-af2e-672ad2f7ed79", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "04d12588-e959-4985-bd1d-9119b4dad186", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40b0900f-4be2-4203-9b91-876bcd855a21", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6c0ce61-a230-47d9-8dc4-3470efb49860", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0f3a3447-ef64-48fa-b1fb-93fe83b217d3", "name": "Get a hierarchy's children", "request": { "name": "Get a hierarchy's children", "description": { "content": "Get a hierarchy's children\n\n#### Filtering\n\nMany Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n|----------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|------------------------------------------|\n| `eq` | `id`, `hierarchy_id`, `owner`, `parent_id`, `name`, `slug`, `description`, `has_children`, `created_at`, `updated_at`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.id`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Equals. Checks if the value of the attribute matches the specified value. | `filter=eq(name,some-name)`, `filter=eq(locales.fr-FR.name,Nom-du-produit)` |\n| `in` | `id`, `hierarchy_id`, `parent_id`, `breadcrumbs.id` | Checks if the value of the attribute is included in the specified list. | `filter=in(id,1,2,3,4)` |\n| `lt`, `le`, `gt`, `ge` | `id`, `hierarchy_id`, `parent_id`, `created_at`, `updated_at` | Comparison operators. `lt`: Less than, `le`: Less than or equal to, `gt`: Greater than, `ge`: Greater than or equal to. | `filter=lt(id,100)`, `filter=ge(created_at,2022-01-01)` |\n| `like` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Like. Checks if the attribute contains the specified string (wildcards supported). | `filter=like(name,*some-name*)`, `filter=like(locales.es-ES.description,*descripción*)` |\n| `ilike` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Case-insensitive like. Same as `like` but ignores case when matching. | `filter=ilike(name,*some-name*)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "in(id,some-id)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "lt(id,100)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "le(created_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "gt(updated_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "ge(parent_id,500)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(locales.fr-FR.name,Nom-du-produit)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ed9ba10a-e4d7-4fd5-bdd1-61d81497d43c", "name": "Returns the hierarchy's children.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"type\": \"node\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"attributes\": {\n \"description\": \"All Dress Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures habillées\",\n \"description\": \"Toutes les chaussures habillées\"\n }\n },\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:50:21.729Z\",\n \"owner\": \"store\",\n \"sort_order\": 3,\n \"updated_at\": \"2024-01-11T19:50:21.729Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 2 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86a1b2ef-cdee-4328-8e46-25dccaea8a59", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23d47a36-5fb7-40f1-98f7-18a75a8e37e2", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2bd3a6a-1bb4-4aed-8901-979709f34c12", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c0d3a411-5863-49a4-9d71-a8459b715bb1", "name": "Create relationships between a hierarchy and child nodes", "request": { "name": "Create relationships between a hierarchy and child nodes", "description": { "content": "Use this endpoint to create relationships between a hierarchy and one or more child nodes. You can create a relationship only if:\n\n- All child nodes already exist.\n- Every child node in the request body must belong to this hierarchy.\n- All siblings in a hierarchy must have a unique `name` and `slug`. Siblings are the child nodes that are related to the same parent.\n\n### Sort Order\n\nYou can also provide `sort_order` information when you create a relationship by adding a `meta` object to the array of node reference objects for each child node that requires sorting.\n\nThe node with the highest value of `sort_order` appears at the top of the response. For example, a node with a `sort_order` value of `3` appears before a node with a `sort_order` value of `2`.\n\n- If you don’t provide `sort_order` when creating relationships, all child nodes in the response for Get a Hierarchy’s Children request are ordered by the `updated_at` time in descending order. The most recently updated child node appears at the top of the response.\n- If you set `sort_order` for only a few child nodes or not all, the child nodes with `sort_order` value appear first in the response and then other child nodes appear in the order of `updated_at` time.\n\nYou can also specify a `sort_order` when creating and updating a node.\n\n- If you create or update a node (**Node A**) with a `sort_order` and then you create a relationship for **Node A** with hierarchy (**Hierarchy A**) with a new `sort_order`, the `sort_order` you specified when creating\\updating **Node A** is overwritten.\n- If you create\\update **Node A** and then you create a relationship with **Hierarchy A** but do not configure a `sort_order`, the `sort_order` you specified when you created\\updated **Node A** is not overwritten.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "82db38a1-44b6-459e-9519-b98459b330f1", "name": "Successfully returns the hierarchy", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"attributes\": {\n \"description\": \"Shoes Category Updated\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures mises à jour\",\n \"description\": \"Catégorie de chaussures mise à jour\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"owner\": \"store\",\n \"updated_at\": \"2024-01-10T20:30:50.867Z\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes Updated\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e481b9c-c055-4c36-b92f-362d8a31e4a5", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f22ad3df-ccb8-4fb5-8577-e3f404d3610f", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee273024-2c4a-41ee-b2c8-9dcd0f83da4e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bddb914c-9a74-44bd-ac3a-5d38cfc1c871", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "65c39031-b8c5-46eb-8609-4e25fba7c716", "name": "Create relationships between a node and child nodes", "request": { "name": "Create relationships between a node and child nodes", "description": { "content": "Use this endpoint to create relationships between a single parent node and one or more child nodes. You can create a relationship only if:\n\n- The parent node already exists.\n- All child nodes already exist.\n- Every child node in the body of the request exists in the same hierarchy as the parent node.\n- A node is not a parent of itself. An array of child nodes request body must not contain the ID of the parent node in the path.\n- All siblings in a hierarchy must have a unique `slug`. Siblings are the child nodes that are related to the same parent.\n\n### Sort Order\n\nYou can also provide `sort_order` information when you create a relationship by adding a `meta` object to the array of node reference objects for each child node that requires sorting.\n\nThe node with the highest value of `sort_order` appears at the top of the response. For example, a node with a `sort_order` value of `3` appears before a node with a `sort_order` value of `2`.\n\n- If you don’t provide `sort_order` when creating relationships, all child nodes in the response for Get a Node’s Children request are ordered by the `updated_at` time in descending order. The most recently updated child node appears at the top of the response.\n- If you set `sort_order` for only a few child nodes or not all, the child nodes with `sort_order` value appear first in the response and then other child nodes appear in the order of `updated_at` time.\n\nYou can also specify a `sort_order` when creating and updating a node.\n\n- If you create or update a node (**Node A**) with a `sort_order` and then you create a relationship for **Node A** with another node (**Node B**) with a new `sort_order`, the `sort_order` you specified when creating\\updating **Node A** is overwritten.\n- If you create\\update **Node A** and then you create a relationship with **Node B** but do not configure a `sort_order`, the `sort_order` you specified when you created\\updated **Node A** is not overwritten.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "979815c5-2097-4a46-bcdc-1ccecf53efed", "name": "Successfully returns the parent node", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a494b43c-2eff-47eb-b89f-52c575259cb7", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bc6ce9a-5c5a-4f7f-ada5-b56e4a3ef75b", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "193b5280-6eb4-4a5e-8404-35ed5e969f81", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebbdb108-d52f-4c18-9ada-4a0bffa441f5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "children" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e717c8dd-521f-4948-aca0-1f820b9f1710", "name": "Get a node's children", "request": { "name": "Get a node's children", "description": { "content": "Retrieves the child nodes for a specified node.\n\n#### Filtering\n\nMany Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description | Example |\n|----------------|------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|------------------------------------------|\n| `eq` | `id`, `hierarchy_id`, `owner`, `parent_id`, `name`, `slug`, `description`, `has_children`, `created_at`, `updated_at`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.id`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Equals. Checks if the value of the attribute matches the specified value. | `filter=eq(name,some-name)`, `filter=eq(locales.fr-FR.name,Nom-du-produit)` |\n| `in` | `id`, `hierarchy_id`, `parent_id`, `breadcrumbs.id` | Checks if the value of the attribute is included in the specified list. | `filter=in(id,1,2,3,4)` |\n| `lt`, `le`, `gt`, `ge` | `id`, `hierarchy_id`, `parent_id`, `created_at`, `updated_at` | Comparison operators. `lt`: Less than, `le`: Less than or equal to, `gt`: Greater than, `ge`: Greater than or equal to. | `filter=lt(id,100)`, `filter=ge(created_at,2022-01-01)` |\n| `like` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Like. Checks if the attribute contains the specified string (wildcards supported). | `filter=like(name,*some-name*)`, `filter=like(locales.es-ES.description,*descripción*)` |\n| `ilike` | `name`, `slug`, `description`, `locales.[locale].name`, `locales.[locale].description`, `breadcrumbs.name`, `breadcrumbs.slug`, `breadcrumbs.locales.[locale].name` | Case-insensitive like. Same as `like` but ignores case when matching. | `filter=ilike(name,*some-name*)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(name,some-name)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(name,*some-name*)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "in(id,some-id)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "lt(id,100)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "le(created_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "gt(updated_at,2023-01-01)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "ge(parent_id,500)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(locales.fr-FR.name,Nom-du-produit)" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0203db04-01b9-4f3e-9edf-f42545144929", "name": "Successfully returns the node's children", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"type\": \"node\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n },\n {\n \"type\": \"node\",\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"attributes\": {\n \"description\": \"All Dress Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussures habillées\",\n \"description\": \"Toutes les chaussures habillées\"\n }\n },\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/b2f5e53e-de3c-4548-98da-120f8b185d34/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:50:21.729Z\",\n \"owner\": \"store\",\n \"sort_order\": 3,\n \"updated_at\": \"2024-01-11T19:50:21.729Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"b2f5e53e-de3c-4548-98da-120f8b185d34\",\n \"name\": \"Dress Shoes\",\n \"slug\": \"dress-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 2 in French\"\n }\n }\n }\n ]\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb266971-80f1-4b56-90aa-c81fca139029", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2293678d-da6f-4959-a40f-a38a652576d7", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ea45e6c-7b8f-406e-ab0a-17485ffd440e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "children" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "like(locales.es-ES.description,*descripción*)" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e546817f-c604-47ad-8333-e6cb87761f9a", "name": "Update a node's parent", "request": { "name": "Update a node's parent", "description": { "content": "Changes the parent of the specified node. The new parent node must be located within the same hierarchy as the specified node.\n\nYou cannot move a node to another hierarchy. If you want to put the specified node into another hierarchy, create the node in the target hierarchy and delete it from the current hierarchy.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "817b7a36-8d3e-4ee2-9841-832c4b6e392f", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4c64e485-c212-406e-93eb-cb4f070e1759", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b3347e7-bff5-4bb0-a5dd-14c4d963eb99", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a63e8cc5-6669-408c-b543-c3eb24a5a05a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23a8369a-8fe1-4ccb-90a8-fd2c3be1e3bf", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"60dc3982-ab34-47e8-9173-c920c63dc382\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa89972a-365e-4f67-86fe-fa780212bfb9", "name": "Delete a node's parent", "request": { "name": "Delete a node's parent", "description": {}, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "0df4544a-5512-41fd-b42f-40dd96242f4c", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "40e3e48a-72ed-4e90-9e94-b11fea502e80", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9185434-cf04-46ea-907a-3fed0860cc2a", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13ebfc15-02e4-4ea2-8265-4e7ea1206aa9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1866d071-984c-4692-ae66-54318429d9e1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "parent" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d186e768-68ef-45e5-b76f-a20f26f20b1a", "name": "Create a node's product relationships", "request": { "name": "Create a node's product relationships", "description": { "content": "Creates relationships between the specified node and one or more products in a specified hierarchy.", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "816b3942-72d8-4bb1-b206-2f07cb29d4a9", "name": "Successfully returns the updated node", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc8cd0be-cd34-4d82-a61e-eb2482daec42", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39574cec-38e0-4836-a797-d4aa0cd2f91c", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2152c53-dc95-4b24-80bb-5dece7efaaf0", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82e51a88-ffae-480f-ac3f-cf69bf2d9022", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "641ec81b-57b9-4244-909c-b111b9e9e14e", "name": "Deletes a node's product relationships", "request": { "name": "Deletes a node's product relationships", "description": {}, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "05b14a13-48db-49f2-b54d-a64a56ebc160", "name": "Successfully returns the updated node", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"node\",\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"attributes\": {\n \"description\": \"Latest Ballet Shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Chaussons de ballet\",\n \"description\": \"Dernières chaussures de ballet\"\n }\n },\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\"\n },\n \"shopper_attributes\": {\n \"charge_type\": \"credit card\"\n },\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\"\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children\"\n }\n },\n \"products\": {\n \"data\": [],\n \"links\": {\n \"related\": \"/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2024-01-11T19:19:50.087Z\",\n \"owner\": \"store\",\n \"sort_order\": 5,\n \"updated_at\": \"2024-01-11T19:56:53.695Z\",\n \"hierarchy_id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"breadcrumbs\": [\n {\n \"id\": \"6183d10c-94b5-4caa-9f12-2f14cb738d41\",\n \"name\": \"Shoes\",\n \"slug\": \"shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"hierarchy 1 in French\"\n }\n }\n },\n {\n \"id\": \"9ea0de15-3347-43dd-8faa-cd32f44a04c7\",\n \"name\": \"Ballet Shoes\",\n \"slug\": \"ballet-shoes\",\n \"locales\": {\n \"fr-FR\": {\n \"name\": \"Node 1 in French\"\n }\n }\n }\n ]\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "caea8952-2f2a-408e-b296-0e36a9ad7d37", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9347ca9-1eec-47ee-9e1c-41592355f53a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fda4b8d-b39e-4ac2-ab3a-c7e22e5d8ba8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "relationships", "products" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5ea9b1e7-1653-446e-95f4-5549b7cf3fc0", "name": "Get a node's products", "request": { "name": "Get a node's products", "description": { "content": "Returns the products associated with the specified hierarchy node from a published catalog. Products must be in a live status. If the products have been curated using the update a hierarchy node endpoint, then the products are returned in the order specified in the `curated_products` attribute in the body of the update a hierarchy node request. A product that is curated has the \"curated_product\": true attribute displayed.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } }, { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID", "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c9233e2a-a059-4eeb-92cb-27f4536bbc8b", "name": "Successfully returns the node's products", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"custom_inputs\": {\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"description\": \"T-shirt.\",\n \"mpn\": \"1234-5678-TTTT\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"status\": \"live\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"extensions\": {\n \"products(size)\": {\n \"widthMM\": 600,\n \"fuelType\": \"electric\",\n \"hasUKPlug\": true,\n \"online\": null\n }\n }\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/children\"\n }\n },\n \"component_products\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/component_products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/files\"\n }\n },\n \"main_image\": {\n \"data\": null\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/templates\"\n }\n },\n \"variations\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/variations\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2022-08-18T14:25:57.391Z\",\n \"owner\": \"store\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2022-08-18T14:25:57.391Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7456deb2-e788-4201-a1c8-44a723ad8346", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b84f1adf-3b95-4cc6-aa46-b200c1f45a8d", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4755d9f9-a637-49c5-9912-5e7752e9355d", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "nodes", ":nodeID", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier for the node.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "nodeID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b95d83b-e9aa-4ef4-8063-f01b70a3e6db", "name": "Duplicate a hierarchy", "request": { "name": "Duplicate a hierarchy", "description": { "content": "Using this option, you can duplicate an existing hierarchy. This is useful because it enables you to quickly and easily create multiple hierarchies with the same node structure.\n\nWhen you duplicate a hierarchy, you can specify a new name and/or a new description for the duplicated hierarchy. All other attributes, such as slug and locales, stay the same.\n\nAny nodes in the existing hierarchy are also replicated in the duplicated hierarchy. In addition, you can optionally use the `include_products` attribute to specify whether you want products associated with the nodes in an existing hierarchy to be associated with the nodes in the duplicated hierarchy. By default, product relationships in an existing hierarchy are not duplicated in a duplicate hierarchy.\n\nDuplicating a hierarchy is an asynchronous operation. When you duplicate a hierarchy, a job is created. The jobId of the job is displayed in the response. When the job is complete, the duplicate hierarchy operation is also complete. You can use the jobId to see the status of your job using Get a Job.\n\nJobs are processed one at a time. You can continue to send duplicate hierarchy requests, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed. \n\nOnce the job is complete, run:\n\n- Get all hierarchies to retrieve the HierarchyId of your duplicated hierarchy.\n- Get a hierarchy to retrieve the nodes and (if applicable) products associated with the duplicated hierarchy.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "duplicate_job" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID", "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"New Shoes\",\n \"description\": \"New Shoes Category\",\n \"include_products\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "beedc18f-fe30-4b0b-afa0-581112040a9d", "name": "Successfully returns the duplicate hierarchy job ID", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "duplicate_job" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"New Shoes\",\n \"description\": \"New Shoes Category\",\n \"include_products\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"1d9b101e-a40a-4e53-9f54-08a9ede65019\",\n \"attributes\": {\n \"completed_at\": null,\n \"created_at\": \"2024-01-11T22:49:10.338Z\",\n \"started_at\": null,\n \"status\": \"pending\",\n \"type\": \"hierarchy-duplicate\",\n \"updated_at\": \"2024-01-11T22:49:10.338Z\"\n },\n \"meta\": {\n \"x_request_id\": \"40995a1d-c0c1-4d52-a178-bfb5399ab0ec\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fea4ef4-8282-4246-805a-b2626fe04f97", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "duplicate_job" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"New Shoes\",\n \"description\": \"New Shoes Category\",\n \"include_products\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ff8d850-3b18-43d9-b3f2-65765384da73", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "duplicate_job" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"New Shoes\",\n \"description\": \"New Shoes Category\",\n \"include_products\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b14db87-879d-48c8-a015-0df4fa9ad625", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "hierarchies", ":hierarchyID", "duplicate_job" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the hierarchy.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "hierarchyID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"hierarchy\",\n \"attributes\": {\n \"name\": \"New Shoes\",\n \"description\": \"New Shoes Category\",\n \"include_products\": true\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Jobs", "description": "```mdx-code-block\nimport ProductJobs from '/docs/partials/pxm/jobs/jobs.mdx';\n\n\n```\n", "item": [ { "id": "5dda9457-158d-4412-bab3-81b2fe892f76", "name": "Get All Jobs", "request": { "name": "Get All Jobs", "description": { "content": "The jobs endpoints displays the status of a number of endpoints that function as jobs, for example, product import and export, price book import, building child products, and duplicating hierarchies.", "type": "text/plain" }, "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7f1ccf5b-a65b-451a-939b-3fa6c6a116ca", "name": "Returns all the jobs.", "originalRequest": { "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"pim-job\",\n \"id\": \"1ea62172-57f6-45e5-a708-ab5bd634e3f9\",\n \"attributes\": {\n \"completed_at\": \"2024-01-05T13:46:42.142Z\",\n \"created_at\": \"2024-01-05T13:46:41.695Z\",\n \"started_at\": \"2024-01-05T13:46:42.07Z\",\n \"status\": \"success\",\n \"type\": \"product-import\",\n \"updated_at\": \"2024-01-05T13:46:42.07Z\"\n },\n \"meta\": {\n \"x_request_id\": \"7e832a26-d615-4305-b26a-e33c9c2fc06a\"\n }\n },\n {\n \"type\": \"pim-job\",\n \"id\": \"3ab3deca-1f11-47b7-a409-24ea3234d72c\",\n \"attributes\": {\n \"completed_at\": null,\n \"created_at\": \"2024-01-05T15:27:23.161Z\",\n \"started_at\": \"2024-01-05T15:27:23.65Z\",\n \"updated_at\": \"2024-01-05T15:27:23.65Z\",\n \"status\": \"started\",\n \"type\": \"product-import\"\n },\n \"meta\": {\n \"x_request_id\": \"9ac00140-0037-4c6a-913c-b812196a2de6\"\n }\n },\n {\n \"type\": \"pim-job\",\n \"id\": \"7e1b9ba1-c844-4556-9b16-4ae3f0988b0f\",\n \"attributes\": {\n \"completed_at\": \"2024-01-05T15:27:23.663Z\",\n \"created_at\": \"2024-01-05T15:27:23.161Z\",\n \"started_at\": \"2024-01-05T15:27:23.65Z\",\n \"updated_at\": \"2024-01-05T15:27:23.65Z\",\n \"status\": \"success\",\n \"type\": \"product-export\"\n },\n \"meta\": {\n \"file_locations\": [],\n \"filter\": \"eq(sku,product-1)\",\n \"x_request_id\": \"fad8c5c0-9546-4e0c-b68e-8a2d809891e5\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05a260aa-4ba2-4207-b37d-3acb33e3dbaa", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acf025e5-9c3b-4a06-a3a5-6ae197530ba2", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10ae3e0f-c43f-4663-b260-8d6f1b32c879", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f548d91-28da-4bb1-b7f8-0cbec0542bb4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "26fc8090-2c76-443c-9e88-6259b259fadd", "name": "Get a Job", "request": { "name": "Get a Job", "description": {}, "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID", "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8977fac2-5ef9-48b3-9252-1a0506872c37", "name": "Returns a job with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"1ea62172-57f6-45e5-a708-ab5bd634e3f9\",\n \"attributes\": {\n \"started_at\": null,\n \"completed_at\": null,\n \"created_at\": \"2024-01-05T13:46:41.695Z\",\n \"status\": \"started\",\n \"type\": \"product-import\",\n \"updated_at\": \"2024-01-05T13:46:42.07Z\"\n },\n \"meta\": {\n \"x_request_id\": \"7e832a26-d615-4305-b26a-e33c9c2fc06a\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "415f7db4-555b-422e-80ae-8764e3a8094e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5de399e4-a7c1-4221-8f8b-0261e7897bdb", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d37acc76-46c1-4fed-a5a6-ad2a522b7b46", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54f46d10-a072-40d9-971c-7aa58a8f6774", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7da47dc7-a69b-4c18-80e8-298c96975486", "name": "Cancel a Job", "request": { "name": "Cancel a Job", "description": { "content": "The jobs endpoints display the status of a number of endpoints that function as jobs, for example, product import and export, and duplicating hierarchies.\n\nJobs are processed one at a time. You can continue to send job requests, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date. If you decide that a specific job needs to be prioritized over another, you can cancel the less critical job using the `Cancel a job` endpoint. You can only cancel jobs whose status is PENDING.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID", "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d06f5f24-0a87-43d8-9f59-7100ea12bd76", "name": "Successfully cancelled job", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"pim-job\",\n \"id\": \"1e5da4bf-b2c0-4619-bb3d-f749875b15bb\",\n \"attributes\": {\n \"started_at\": null,\n \"completed_at\": null,\n \"created_at\": \"2023-11-14T15:37:13.589Z\",\n \"status\": \"cancelled\",\n \"type\": \"product-import\",\n \"updated_at\": \"2023-11-14T15:37:13.589Z\"\n },\n \"meta\": {\n \"x_request_id\": \"4fde01c1-95ba-4dd6-948e-b9d5763ff9c2\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d95af3c-9b48-42f6-a0cf-a72b4e5de638", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33c3e4a5-cbee-48ce-81ae-2804d3ddffac", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5097284-2b2d-4bb8-a60b-bd91a637fd18", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d02fa70-6379-4229-ad08-82da86ffe6f3", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3675f614-e23e-4150-b713-48ca16d42625", "name": "Get Job Errors", "request": { "name": "Get Job Errors", "description": {}, "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID", "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c85579a1-9262-4290-acbe-1a3002f24cc9", "name": "Successful", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"pim-job-error\",\n \"id\": \"2950cae3-1050-4c43-9fbd-2aa60dc5c249\",\n \"attributes\": {\n \"message\": \"data.attributes.sku: Must be unique amongst products.\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7ef3d2c-6bdd-4f26-80a8-053bd0600174", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba72e153-2351-40d1-a60a-8322ad558fec", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7fb03b3-8b3e-4e03-849d-ece50ed94b7b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9babfeb4-decc-401e-87c5-a7cd976bcf5e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "jobs", ":jobID", "errors" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the job.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product Relationships", "description": "", "item": [ { "id": "1ece686b-6941-43ec-92f3-5eb01f74e374", "name": "Attach Custom Relationships to a Product", "request": { "name": "Attach Custom Relationships to a Product", "description": { "content": "You can attach up to 5 custom relationships to a product. \n\nOnce you have attached a custom relationship to a product, you can then create relationships from a product to one or many other products. See [Associate a product to one or more products using a custom relationship](/docs/api/pxm/products/product-association-id). \n\nSee [Custom Relationships](/guides/key-concepts/product-experience-manager/custom-relationships/).\n\n### Prerequisites\n - A Custom Relationship has been created, see [create a Custom Relationship](/docs/api/pxm/products/create-custom-relationship),\n - A Product has been created.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "57b38b43-658d-4341-a15c-56826ab366a3", "name": "Returns the attached custom relationships", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"21b1315b-c47f-4766-85bf-7bf0f94d73b6\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"bi_directional\": true\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"e390ff7e-efc4-4769-90d2-fceabcc1e2cd\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n ],\n \"links\": {\n \"last\": \"/pcm/custom_relationships?page[offset]=29&page[limit]=1\",\n \"next\": \"/pcm/custom_relationships?page[offset]=1&page[limit]=1\"\n },\n \"meta\": {\n \"results\": {\n \"total\": 3\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae00b50c-2845-4b2e-9087-c9a52dd394c6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee960247-8b0a-4826-bc89-411ef0b5479d", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "155c78fd-5fef-4ed2-881d-79f96644080a", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5ea8fe8-1e9f-47b1-978d-fd8c1170dcfc", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b12b5b1-ec51-4f56-bb68-8c81f3007d0d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "274607b7-04bb-4212-b712-72a1d533e746", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "95ddfb04-8c3d-4f8b-9344-b82af3b0200a", "name": "Delete Custom Relationships from a Product", "request": { "name": "Delete Custom Relationships from a Product", "description": { "content": "Delete Custom Relationships from a Product. Multiple Custom Relationships can be deleted from a product in one request.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "82896ad0-5a06-4d93-8cb3-69be9e804910", "name": "Successfully deleted custom relationships.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "97f62e02-0925-4e48-bbcf-f57403491299", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c694381-6b0f-40c2-88f2-b98fb51407e1", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a57f53a-cfbd-44e2-aae5-9b7b24334367", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74b1d684-739b-4ef7-be0e-e9d8add7e718", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "561e9d6c-5846-436a-973e-8fbae33f870c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ea296e7-0dc3-41ae-b23a-0cd6a9a55419", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "04800929-3e39-4971-857c-568b813f12c3", "name": "Get all Custom Relationships attached to a Product", "request": { "name": "Get all Custom Relationships attached to a Product", "description": { "content": "### Prerequisites\n - Custom Relationships have been attached to a product, see [Attach Custom Relationships to a Product](/docs/api/pxm/products/attach-custom-relationships)\n - **OR** Products have been related to one another, see [Create a Relationship between a product with one or more products](/docs/api/pxm/products/product-association-id)\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8bc6ee6a-6378-4188-a999-877e61597224", "name": "Returns the attached custom relationship.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"21b1315b-c47f-4766-85bf-7bf0f94d73b6\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"bi_directional\": true\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"e390ff7e-efc4-4769-90d2-fceabcc1e2cd\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n ],\n \"links\": {\n \"last\": \"/pcm/custom_relationships?page[offset]=29&page[limit]=1\",\n \"next\": \"/pcm/custom_relationships?page[offset]=1&page[limit]=1\"\n },\n \"meta\": {\n \"results\": {\n \"total\": 3\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f221c221-8491-4567-8a39-8a4b32a4feb7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c4c6daa-91cc-4a57-b3c9-dc1e2302af14", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b56da57b-ad2e-459a-9e03-9494c3843526", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12bf1fb6-630a-4818-9afa-bbb724b27bf3", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e991da71-1ad1-419c-9289-d4047f72e772", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bca354cb-89da-476c-b4fa-acd6f4a30f1a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_related_products\"\n },\n {\n \"type\": \"custom-relationship\",\n \"slug\": \"CRP_cart_products\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e65bf99-455f-4e71-8853-854f8782def5", "name": "Create a Relationship between a Product with one or more Products", "request": { "name": "Create a Relationship between a Product with one or more Products", "description": { "content": "- You can associate a product with up to 2000 other products. \n- You do not need to attach a custom relationship to products beforehand, this will be done automatically by this endpoint. \n- This is a partial update, so if you make a request to this endpoint multiple times with different products in each request, they will not be overwritten but will be appended to the related products list. \n\nIf you want to remove a relationship between products, see [Delete a Relationship between a product with one or more products](/docs/api/pxm/products/dissociate-products). \n\n ### Prerequisites\n - A Custom Relationship has been created, see [create a Custom Relationship](/docs/api/pxm/products/create-custom-relationship).\n - A Product has been created for the relationship to be based from.\n - One or many Product have been created for the product to relate to.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } }, { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1f70c0ed-9bdc-467a-92d3-0bee98ffcca7", "name": "Returns information related to associated products.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"meta\": {\n \"associated_products\": [\n \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n ],\n \"products_not_associated\": [\n {\n \"ID\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\",\n \"Details\": \"could not find product\"\n },\n {\n \"ID\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"Details\": \"product already has 5 custom relationships, cannot associate more as it has reached the limit of 5 custom relationships\"\n },\n {\n \"ID\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\",\n \"Details\": \"product already has 5 custom relationships, cannot associate more as it has reached the limit of 5 custom relationships\"\n },\n {\n \"ID\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\",\n \"Details\": \"product exceeds the maximum limit of associated products (2000). Please review and try again\"\n }\n ],\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-08-08T09:29:08.295Z\",\n \"updated_at\": \"2024-08-08T09:29:08.295Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00ed12ae-8a31-4752-bca3-514890a4d8bc", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31337940-7504-4a4e-be6f-6ea86e6ec5c5", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a7bbac4-f6bf-4f5c-bb13-092dc2ce4128", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3d04cb9-e73e-45d5-8074-68b15bdbb392", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1507a5c-e6e5-49f5-9a70-c2465aefe4b4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47c22aa6-2116-486c-89a3-4a9b1fb34acf", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\",\n \"attributes\": {\n \"sort_order\": 2\n }\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7ac74490-6959-4806-b5e0-20f06a88272d", "name": "Delete a Relationship between a product with one or more products", "request": { "name": "Delete a Relationship between a product with one or more products", "description": {}, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } }, { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e408e771-5edb-4f11-9595-857b5f4f73b2", "name": "Products are dissociated.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "42370531-0fd8-4450-b04f-7779cad53f03", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffd002be-d5fc-4e5c-b4c0-88455658b327", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f24d9e81-fc56-489b-ae0f-ce7a78356a14", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0711530e-2518-43eb-b7a1-bdbbfa880cc6", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b0340a5-b770-4969-b180-bd03dbcbfb2e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c45989e-e15a-443a-9437-4de4ffeba46c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\"\n },\n {\n \"type\": \"product\",\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\"\n },\n {\n \"type\": \"product\",\n \"id\": \"97b7fac2-91dd-4755-81b0-bdffe8e7eabd\"\n },\n {\n \"type\": \"product\",\n \"id\": \"a0ef3291-2ec1-4d7d-9d6d-1705ae01bb99\"\n },\n {\n \"type\": \"product\",\n \"id\": \"bde79675-4783-40b7-8a7e-ac6df41459c6\"\n },\n {\n \"type\": \"product\",\n \"id\": \"aaddd5f4-a5f8-42e8-be9a-097986f22e58\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "be3e91d7-8f3c-4126-ad4b-0ebdd9d7df7b", "name": "Get all Related Product IDs of a Products' attached Custom Relationship", "request": { "name": "Get all Related Product IDs of a Products' attached Custom Relationship", "description": { "content": "### Prerequisites\n - Relationships have been created between Products, see [Create a Relationship between a product with one or more products](/docs/api/pxm/products/product-association-id).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } }, { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "dd7ae594-a3eb-4e5e-b0d9-3fca6f8bec6a", "name": "Returns all related product ids.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"68c48149-0e94-4ef2-93d5-8d5f3774980a\",\n \"type\": \"product\",\n \"attributes\": {\n \"sort_order\": 5\n }\n },\n {\n \"id\": \"ab4826d1-4a5a-4951-a2a5-98058899f891\",\n \"type\": \"product\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e43a351c-a5a7-47c7-8b78-b9ba333cd13f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4d1869e-4e5d-4c32-909f-99eabe095c58", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e48f6b71-6ec5-464d-a178-f3f4f0e86d98", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95f0c5bf-4408-4644-9819-01aced42af67", "name": "Write conflict detected", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Conflict\",\n \"status\": \"409\",\n \"detail\": \"write conflict detected\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "008d1586-1274-4084-872c-150badb99dbe", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41826260-b0f9-4995-b10b-515137a20f98", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d33b69f0-7055-4ea7-a08e-ad3d92a3d912", "name": "Get all Related Products of a Products' attached Custom Relationship", "request": { "name": "Get all Related Products of a Products' attached Custom Relationship", "description": { "content": "### Prerequisites\n - Relationships have been created between Products, see [Create a Relationship between a product with one or more products](/docs/api/pxm/products/product-association-id).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID", "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" } }, { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f5c7e9e0-b0b9-4974-991b-e4154ae829a9", "name": "Returns all related products.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product\",\n \"id\": \"9c85b276-09b4-488e-a59c-c561bae14c9e\",\n \"attributes\": {\n \"commodity_type\": \"physical\",\n \"custom_inputs\": {\n \"back\": {\n \"name\": \"T-Shirt Back\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n },\n \"front\": {\n \"name\": \"T-Shirt Front\",\n \"validation_rules\": [\n {\n \"type\": \"string\",\n \"options\": {\n \"max_length\": 50\n }\n }\n ],\n \"required\": false\n }\n },\n \"description\": \"T-shirt.\",\n \"mpn\": \"1234-5678-TTTT\",\n \"name\": \"T-Shirt\",\n \"sku\": \"97805\",\n \"slug\": \"97805\",\n \"status\": \"live\",\n \"upc_ean\": \"12345656\",\n \"tags\": [\n \"tag1\",\n \"tag2\"\n ],\n \"extensions\": {\n \"products(size)\": {\n \"widthMM\": 600,\n \"fuelType\": \"electric\",\n \"hasUKPlug\": true,\n \"online\": null\n }\n }\n },\n \"relationships\": {\n \"children\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/children\"\n }\n },\n \"component_products\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/component_products\"\n }\n },\n \"files\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/files\"\n }\n },\n \"main_image\": {\n \"data\": null\n },\n \"templates\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/templates\"\n }\n },\n \"variations\": {\n \"data\": [],\n \"links\": {\n \"self\": \"/products/9c85b276-09b4-488e-a59c-c561bae14c9e/relationships/variations\"\n }\n }\n },\n \"meta\": {\n \"created_at\": \"2022-08-18T14:25:57.391Z\",\n \"owner\": \"store\",\n \"product_types\": [\n \"standard\"\n ],\n \"updated_at\": \"2022-08-18T14:25:57.391Z\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d94027c4-e3f8-40de-8071-b90918c94c47", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc1b3e69-e921-4402-a860-7ba5224cf18b", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89f7fceb-105e-4687-8e74-8f1a99092066", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b528e98-f4e1-4f48-acb9-ba92b701d574", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b90876f-28e3-46f0-9ad5-3167a833e2e9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "products", ":productID", "custom-relationships", ":customRelationshipSlug", "products" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) A unique identifier for the product.", "type": "text/plain" }, "type": "any", "value": "00000000-0000-0000-0000-000000000000", "key": "productID" }, { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Custom Relationships", "description": "", "item": [ { "id": "427d517a-1094-4eae-802a-745640b49eac", "name": "Create a custom relationship", "request": { "name": "Create a custom relationship", "description": { "content": "Custom relationships can either be bi-directional or uni-directional.\n - **Uni-Directional**: By setting `bi_directional` to `false` (or omitted from request) a uni-directional custom relationship will be created. \n Within a uni-directional relationship, if Product A links to Product B, Product B will not link back to Product A. \n This is ideal when one product (e.g., a base product) recommends another (e.g., an upsell), but the reverse \n recommendation is unnecessary.\n \n - **Bi-Directional**: By setting `bi_directional` to `true` a bi-directional custom relationship will be created. Within a bi-directional \n relationship, if Product A is linked to Product B, Product B will automatically link back to Product A. \n This bi-directionality ensures a consistent experience, where products always suggest each other as related items.\n \n For more information on use cases, see [Custom Relationships](/guides/key-concepts/product-experience-manager/custom-relationships/).\n\nCustom Relationship slugs must meet the following criteria:\n - be unique \n - be prefixed with `CRP_`. Product Experience Manager automatically adds the `CRP_` prefix if you do not include it.\n - contain A to Z, a to z, 0 to 9, hyphen, underscore, and period. Spaces or other special characters like ^, [], *, and $ are not allowed.\n \nOnce a custom relationship has been created, you can then create Product Relationships:\n 1. Add the custom relationship to a product. See [Attach a custom relationship to a product](/docs/api/pxm/products/attach-custom-relationships).\n 2. Associate a product to multiple products. See [Associate a product with other products under a custom relationship](/docs/api/pxm/products/product-association-id).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c85e2789-a9f6-4bd8-88b8-fff058ba3b89", "name": "Returns a created custom relationship with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62231f57-d9f4-439f-b01b-cdbc7b1eee10", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d3d54258-1baf-4616-8641-cd4f6711c2a2", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b1cb9ef-b57f-4ad8-8690-567a0b5f9131", "name": "Get all custom relationships", "request": { "name": "Get all custom relationships", "description": { "content": "Gets all Custom Relationships. \n\nTo see a list of custom relationships a product is attached to, see [Get all Custom Relationships attached to a Product](/docs/api/pxm/products/list-attached-custom-relationship).\n\nTo see a list of products that a product is related to, see [Get all Related Products of a Products' attached Custom Relationship](/docs/api/pxm/products/get-related-products-of-a-product-id).\n\n### Filtering\n\n Many Commerce API endpoints support filtering. The general syntax is described in [**Filtering**](/guides/Getting-Started/filtering).\n\n The following attributes and operators are supported.\n\n | Operator | Attribute | Description | Example |\n | :--- |:---|:---|:---|\n | `eq` | `owner`, `slug` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. | `filter=eq(owner,store)` |\n | `in` | `slug` | In. Checks if a value exists in a given list of values. If the value matches any item in the list, the condition is true. | `filter=in(slug,slug-1,slug-2,slug-3)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "39356610-4788-49d1-9141-4ac76d7422cc", "name": "Returns a list of all custom relationships.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Kitchen electrics\",\n \"description\": \"Kitchen electric devices\",\n \"slug\": \"CRP_kitchen_individual_devices\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"21b1315b-c47f-4766-85bf-7bf0f94d73b6\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"bi_directional\": true\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n },\n {\n \"id\": \"e390ff7e-efc4-4769-90d2-fceabcc1e2cd\",\n \"type\": \"custom-relationship\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n ],\n \"links\": {\n \"last\": \"/pcm/custom_relationships?page[offset]=29&page[limit]=1\",\n \"next\": \"/pcm/custom_relationships?page[offset]=1&page[limit]=1\"\n },\n \"meta\": {\n \"results\": {\n \"total\": 3\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "376544ce-3a46-4e7c-a87f-5fa845f41d57", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf77098f-ad41-4816-9422-117b3c2174b2", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page. The maximum limit is 100.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "Many Commerce API endpoints support filtering. The general syntax is described [**here**](/guides/Getting-Started/filtering).\n", "type": "text/plain" }, "key": "filter", "value": "eq(owner,store)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ff29b7b3-7859-4360-9de5-3720d72c7873", "name": "Update a custom relationship", "request": { "name": "Update a custom relationship", "description": { "content": "Updates a custom relationship. \n\nA partial update can be performed, where you specify only the fields that need to be changed.\n\nThe custom relationship slug cannot be updated.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5b0abc0d-6f6a-43ea-92a4-932c075905e6", "name": "Successfully returns the updated custom relationship", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b2eef4a-a0af-4e39-acfd-9140f3f02941", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5ffb800-bc3f-4af1-8edc-8e5422076784", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f18d690-89ce-4915-87cd-099c7587021d", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Failed Validation\",\n \"status\": \"422\",\n \"detail\": \" can not be empty\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b1d3aa9-9574-4eee-a233-d634657dd27c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "355875e4-2fdc-4faf-b805-019d2c935f07", "name": "Get a custom relationship", "request": { "name": "Get a custom relationship", "description": { "content": "Gets a Custom Relationship.\n\nTo see a list of custom relationships a product is attached to, see [Get all Custom Relationships attached to a Product](/docs/api/pxm/products/list-attached-custom-relationship).\n\nTo see a list of products that a product is related to, see [Get all Related Products of a Products' attached Custom Relationship](/docs/api/pxm/products/get-related-products-of-a-product-id).\n", "type": "text/plain" }, "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a64aa332-afdd-459f-99e7-a646eace6966", "name": "Returns a custom relationship with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"custom-relationship\",\n \"id\": \"f3297ee8-da90-45e9-ae56-a2654aebbdfe\",\n \"attributes\": {\n \"name\": \"Related Products\",\n \"description\": \"A list of related products shown on the PDP\",\n \"slug\": \"CRP_related_products\",\n \"sort_order\": 5,\n \"external_name\": \"Similar items to consider\",\n \"external_description\": \"Check out these similar products that may also meet your needs or match your preferences.\",\n \"bi_directional\": false\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2024-01-10T20:16:35.343Z\",\n \"updated_at\": \"2024-01-10T20:16:35.343Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03fd5246-c2db-4b65-a07d-6b9d2750394e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "227cb972-3a50-4758-b9f7-684fa2178c1f", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99172c46-b3df-4422-8937-7471b0bb3b50", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6c5c6d87-d3e2-4286-9361-1e49903964d7", "name": "Delete a custom relationship", "request": { "name": "Delete a custom relationship", "description": { "content": "Deletes the specified custom relationship.\n\nCustom Relationships cannot be deleted if they are in use.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug", "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "c327e7b0-f86f-449a-827f-e2ae6ded9333", "name": "No Content", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6778606b-429f-44bc-9a95-18da178aa2b1", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"detail\": \"Could not parse the supplied filter\",\n \"status\": \"400\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ac3a8a3-e91c-4225-bdd4-58f72ee5a034", "name": "Forbidden", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Forbidden\",\n \"status\": \"403\",\n \"detail\": \"entity owned by organization\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee5c0e62-0e3b-4000-a575-f78c31eb7882", "name": "Bad Request. Not Found.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1baeef2e-745b-40b7-bb07-dbd7469f1c60", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "pcm", "custom-relationships", ":customRelationshipSlug" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) A custom relationship slug.", "type": "text/plain" }, "type": "any", "value": "CRP_electric_devices_2024", "key": "customRelationshipSlug" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"500\",\n \"title\": \"Internal Server Error\",\n \"detail\": \"There was an internal server error, you can report with your request id.\",\n \"request_id\": \"635da56d-75a1-43cd-b696-7ab119756b3a\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Price Books", "description": "Price books contain prices for the products in your catalog. Each catalog must have one price book. In your storefront, the product prices are displayed in the currency for the selected locale. If a product in the catalog does not have a price in the price book, the product is displayed without a price. \n\nA price book can be associated with multiple catalogs.\n\nFollowing on from this, you can associate more than one price book with a catalog. Price book stacking allows you to create multiple price books for different scenarios, such as seasonal sales, business versus retail customer pricing, and reward programs. If you have multiple price books, when you create a catalog, you must configure a priority for your price books. Product prices are displayed in the catalog according to the priority of the price books. For example, you may have products that have different prices based on region. You can have a price book with the standard retail pricing and then have a second price book that has different pricing for a different region. See Create a catalog.\n\nA price book contains a list of product SKUs and the prices you want to charge for those products. If your store supports multiple locales, a price book can contain product prices in each of the supported currencies. In addition, you can configure sales and volume (tier) pricing.\n\n:::note\n\nPrice books work with products that are defined using the Product Experience Manager resource model. If your products are defined using an earlier Products resource model, you will need to migrate products to the `pcm/products` resource before you implement price books.\n\n:::\n\nYou can duplicate an existing price book and create a new price book. All products and prices associated with the price book are copied to the new price book. Based on the business requirements, you can use the same data or update the data.\n", "item": [ { "id": "94389a6d-792b-4f2f-98ff-d6c623a3db7e", "name": "Create a Price Book", "request": { "name": "Create a Price Book", "description": { "content": "Creates a price book. You can add the prices to the price book now or update the price book later.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\",\n \"name\": \"Standard Price Book\"\n },\n \"type\": \"pricebook\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a24c9233-bbfa-430b-bf8a-b1dc581d1481", "name": "A price book with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\",\n \"name\": \"Standard Price Book\"\n },\n \"type\": \"pricebook\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://ckpacoCllOTTEOFUaGsmIoJAgcwBck.ctDluzaZ7Bc0NitATCH4sTFLrMtsIkDqFBK\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fbf9e16-7659-46a3-9202-973b587c6e86", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": {\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\",\n \"name\": \"Standard Price Book\"\n },\n \"type\": \"pricebook\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56010050-695b-4707-a7bc-1095a6094228", "name": "Get all Price Books", "request": { "name": "Get all Price Books", "description": { "content": "Retrieves a list of all price books.\n\n### Filtering\n\nFiltering is supported on this endpoint. For the general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n You can filter on the following attributes and operators.\n\n | Operator | Attribute | Description | Example |\n | --- | --- | --- | --- |\n | `eq` | `external_ref` | Equals. Checks if the values you provide matches a price book. | `filter=eq(external_ref,some-external-ref)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "You can filter on this endpoint. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "86357c31-e706-453e-9e30-41e7ac76a6eb", "name": "The list of price books.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "You can filter on this endpoint. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n },\n \"page\": {\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 0,\n \"total\": 1\n }\n },\n \"links\": {\n \"self\": \"https://AJsJbBisKDwRbuoIeBi.hqzvoBaLuW1\",\n \"first\": \"http://psab.xwrpd4CwyZDRF8Tf+8q3\",\n \"last\": \"http://tAKFix.zxunuGgxxiqbHCoMrR5xjhT6Km8jrDGR6VnwDjXZWVRJQj6vcq\",\n \"prev\": \"http://lmSZtG.hzytOHeUrMuo.BVhg\",\n \"next\": \"http://Cbpd.anxliYMHzjGJKkWVMXnTT..E-9sFv14bUEjdARfQnSv\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fc323e2-7733-4e94-a631-eb9690671bc7", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "You can filter on this endpoint. See [Filtering](#filtering).\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd08270d-a5e1-4080-8de3-5bfbf377d49a", "name": "Get a Price Book by ID", "request": { "name": "Get a Price Book by ID", "description": { "content": "Retrieves the specified price book. To include prices in the response, append `?include=prices` to the path.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "To include product prices in a response, add `include=prices`. (This can only be one of prices)", "type": "text/plain" }, "key": "include", "value": "prices" } ], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "279e2911-2370-4136-8229-61a7e3a2cf07", "name": "The price book.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "To include product prices in a response, add `include=prices`. (This can only be one of prices)", "type": "text/plain" }, "key": "include", "value": "prices" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://cyqUMVpPCYwRDfagrvlqmrnCKtGpI.srB7vcf\"\n },\n \"included\": [\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f6d5164-40eb-40a1-9a64-f082eca9400f", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "To include product prices in a response, add `include=prices`. (This can only be one of prices)", "type": "text/plain" }, "key": "include", "value": "prices" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4dc6ec41-377b-4ccd-9841-b3a889a53a6e", "name": "Update a Price Book by ID", "request": { "name": "Update a Price Book by ID", "description": { "content": "Updates the specified price book. Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the price book is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2d5c0368-bce4-4f13-9b42-f03d6b9fda6c", "name": "An updated price book with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://ckpacoCllOTTEOFUaGsmIoJAgcwBck.ctDluzaZ7Bc0NitATCH4sTFLrMtsIkDqFBK\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10918ebf-a83a-4cee-9d1c-0a84747efde5", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "22f6af47-cdf6-4fac-9c04-12d629955d32", "name": "Delete a Price Book by ID", "request": { "name": "Delete a Price Book by ID", "description": { "content": "Deletes the specified price book and all prices in the price book. It does not delete the products. In addition, pricing details in the orders referring to the deleted price book are not deleted.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "9c6373a1-b4b8-4771-8ae7-ff487cd3c04c", "name": "A 204 response indicates that the price book has been deleted.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1c4bc36b-5a60-41d4-b59c-441342816edb", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b615f79-574f-46ee-8f80-30a75f7cced5", "name": "Replicate a Price Book", "request": { "name": "Replicate a Price Book", "description": { "content": "Using this endpoint, you can replicate an existing price book. This is useful because it enables you to quickly and easily create multiple price books with the same pricing structure. When you replicate an existing price book, you can specify a new name, description, and external reference for the replicated price book. Other attributes stay the same.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "replicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a test price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "fe68d73b-fd0f-4ef5-b27d-aada2ddca4a4", "name": "A replicated price book with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "replicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a test price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\",\n \"type\": \"pricebook\",\n \"attributes\": {\n \"name\": \"Standard Price Book\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"external_ref\": \"an-external-ref\",\n \"description\": \"This is a test price book\"\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://ckpacoCllOTTEOFUaGsmIoJAgcwBck.ctDluzaZ7Bc0NitATCH4sTFLrMtsIkDqFBK\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bba4137d-abff-4ab0-ad7d-8fad7a428139", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "replicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"pricebook\",\n \"attributes\": {\n \"description\": \"This is a test price book\",\n \"name\": \"pricebook-store-abc\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Prices", "description": "Price books contain prices for the products in your catalog. Use the Price Books API to create price books and add product prices to the price book.\n\n### Volume (tiers) Pricing\n\nUsing volume (tiers) pricing allows your store to offer different pricing for minimum quantities of items that your customers purchase. When a customer adds sufficient quantity of an item and meets the minimum required quantity for different pricing, all products with that item SKU are discounted in the cart. You can define the price range for different quantities of different items as in the following example:\n\n| Quantity | Price/Each |\n|:---------|:-----------|\n| 1-5 | $10.50 |\n| 6-10 | $10.00 |\n| 11-20 | $9.50 |\n| 21-50 | $8.50 |\n| 51+ | $7.90 |\n\n### Sales Pricing\n\nWith sales pricing, a store can optionally add a sale price to a product price. For example, a store can schedule seasonal pricing on products without creating a new price book and catalog ruleset. Optionally, a store can schedule the date ranges for the sale products. \n\nYou can set a sale price for an item within a bundle so that the product is sold at the sale price when sold as part of the bundle. For example, if you have a bundle consisting of four items, you can apply a discounted price to an item within the bundle to get a bundle sales price. \n\n1. For sale prices in the same price book:\n\n - the schedules must not be exactly the same.\n - schedules can partially overlap. If the schedule does contain overlapping sales prices, the sale price of the smallest sale period is chosen.\n - if you have just one sale price, without a schedule, this is effectively a permanent price. If you want to add more sale prices to the price book, you must configure a schedule for the sale price. \n\n2. Sale prices in different price books can have overlapping schedules.\n\nBoth list and sale price (or was/is prices) are available in the catalog response, enabling you to display slash pricing on your storefront, depending on your requirements.\n\n### Creating a bundle sale price\n\nYou can assign a sale price to an option in a bundle.\n\n1. In the product price book, create a sale.\n2. Specify the bundle ID that contains the option you want to provide a sale price for.\n3. Provide the sale price for the option. You can add the same sale price for the same option using an array of bundle_ids if you want to sell the product as part of different bundles.\n\n### Understanding Volume and Sale Pricing Behavior for Products\n\nIf you have configured both sale and volume pricing for your products and product bundles, the following table describes how pricing behaves in the following scenarios.\n\n| Scenario | Description |\n| --- | --- |\n| Minimum quantities for volume pricing and sale pricing |
  • (With sale schedule) If you have specified a minimum quantity of five whose price is $0.99 and at the same time, you have configured a sale for the time of purchase, then when a shopper checks out with 5 or more items, the total is based on the volume pricing. In other words, $0.99 × 5 = $4.95. Additionally, if volume pricing exist for both the product price and the sale, the volume pricing for the sale takes precedence. If no volume pricing is set in the sale, the base sale price is applied, and the volume pricing for the product price will not be applied.
  • (With sale schedule) If a shopper's items in the cart do not meet the minimum quantity required for volume pricing, the total is calculated based on the sales price.
  • (Without sale schedule) If the sale is a permanent sale and volume pricing is only set for the product price, then regardless of the quantity a shopper adds to a cart, the final price is always calculated based on the base sales price. However, if volume pricing has been set for the sale, the final price will be determined by the volume tier pricing set in the sale, not the base sales price.
\n| Two levels of volume pricing with different prices for each volume. | If you have configured two levels of volume pricing, for example, the first minimum quantity is 5 and the second minimum quantity is 10:
  • When the quantity in the cart is => 5, then the price for the minimum quantity of 5 is used.
  • When the quantity in the cart is => 10 then the price for the minimum quantity of 10 is used.
|\n\n### Optimizing product prices\n\nYou can add custom attributes to a product price, allowing your storefront to dynamically use these attributes in it's pricing and display logic. This enables you to optimize your pricing data, enhancing your ability to respond to market dynamics and customer preferences. Some examples of pricing optimization strategies are:\n\n- dynamic pricing - allows you to change the price of a product based on changes in customer demand, for example, raising prices during the high-demand holiday season or segment-focused, like special offers for new customers.\n- value-based pricing - allows you to offer different pricing tiers, for example, \"pro\" features cost more.\n- cost-plus pricing - allows you to set prices by adding a specific percentage to the production cost of a single unit.\n\nThere are two types of custom attributes:\n\n- `admin_attributes` - `admin_attributes` are not displayed in catalogs. This means `admin-attributes` can only be viewed by administrators. For example, you may want to add custom attributes that can automate price updates based on predefined rules, saving time and reducing human error or you might want to integrate price attributes with your other company systems, (ERP, CRM) ensuring consistency and accuracy across platforms.\n- `shopper_attributes` - `shopper_attributes` are displayed in catalogs. This means `shopper_attributes` can be viewed by both shoppers and administrators. For example, you can set prices based on customer segments, offering different prices for wholesale and retail customers or providing discounts to loyal customers. \n\nBoth `admin-attributes` and `shopper_attributes` are structured as key-value pairs. Both the keys and values are `strings`. You can have up to 100 keys for each type of attribute.\n", "item": [ { "id": "0649dbbb-d622-4759-9a83-70765683b117", "name": "Add a Product Price to a Price Book", "request": { "name": "Add a Product Price to a Price Book", "description": { "content": "Price books contain prices for the products in your catalog. Use the Prices API to adds the prices for a product to a specified price book. If the prices for the product already exist in the price book, the operation fails and the existing product prices are not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sku\": \"product-sku-a\",\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"a-external-ref\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "4325d69f-a95f-4838-9d1b-01298713ea78", "name": "A product price with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sku\": \"product-sku-a\",\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"a-external-ref\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9265cf2-49c1-4da4-8a35-819272ec4561", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sku\": \"product-sku-a\",\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"a-external-ref\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "85523a22-aad2-4619-b7ea-672f13912941", "name": "Gets all Prices by Price Book ID", "request": { "name": "Gets all Prices by Price Book ID", "description": { "content": "Retrieves all the product prices in the specified price book.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Attribute | Description | Example |\n| --- | --- | --- | --- |\n| `eq` | `external_ref`, `sku` | Checks if the values you provide matches a price. | `filter=eq(sku,some-sku)` |\n| `in` | `sku` | Checks if the values you provide are included in a product SKU. | `filter=in(sku,some-sku)' |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "bd001bf0-012b-4fb2-9e0b-617e9c4a90b4", "name": "The product price list.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n },\n \"page\": {\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 0,\n \"total\": 1\n }\n },\n \"links\": {\n \"self\": \"http://eOjnLHdPFcoOzFMOYRduzZC.uhlrT1bPDFHZMSTHKJ7pOhAkS\",\n \"first\": \"http://EsVrYqZpJdtOQDMCc.qeqtL2vEYh1vpZ2Xmt7vtUrFJNHpz-PduaHHSW,meJO20z2JwfkyQiWkgQMIR2cICIpcBnJ02Qd2\",\n \"last\": \"https://qMRsnUJYmmdGGrCCFUlZirusCopHOlCE.wfMEpAFdE9X,hdT7u2WjnS.x8cCAYOcxEbctxOQfdeo\",\n \"prev\": \"https://RCQlTlWIWRwxbhSRohUkWUoZViknU.mulxTAYu7kZ9GSmxyeZ\",\n \"next\": \"https://ORL.aavaeL4LegJjgfE.MFz\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "194f5f16-4116-4bc9-8247-e65f0484a9f4", "name": "Unexpected error", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "345687c5-8c3d-4f90-811e-7f41e8b883a7", "name": "Get a Product Price by Price Book ID", "request": { "name": "Get a Product Price by Price Book ID", "description": { "content": "Retrieves a specified product price (`priceId`) in the specified price book (`id`).", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "priceID", "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1772ae7b-1ae9-4a69-8839-13ff477fa8c0", "name": "The product price.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f491898-51c6-440d-af0e-ac7fe993962f", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "39237b52-cbce-4d3d-b8c7-05915b2cc321", "name": "Update a Product Price in a Price Book", "request": { "name": "Update a Product Price in a Price Book", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the price is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "priceID", "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "86aec998-6747-4a65-89e5-1a16d270908e", "name": "An updated product price with the following attributes.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5529f4de-5979-45fb-8f7b-4ed93963399f", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n \"links\": {\n \"self\": \"https://tOceuiNdPq.sqsdM2nJPD8DHZNq0ZWNHH+YoQHjE8NrsYUh2zqjb5TL.2BjV2bpI+Q06OJwDZIvMzsscMjykr9W1OaWAqEbOOgeddec\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "30c550ab-2a99-4f17-8c0c-238d2f6400c1", "name": "Delete a Product Price from a Price Book", "request": { "name": "Delete a Product Price from a Price Book", "description": { "content": "Deletes a product price from the specified price book.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "priceID", "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "7c7b586f-3c03-4766-b754-148e51ee8bca", "name": "A 204 response indicates that the product prices have been deleted", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1b5aafe1-3324-4171-a887-8ae90ebf875d", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "prices", ":priceID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a price book.", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) A unique identifier of a price book price.", "type": "text/plain" }, "type": "any", "value": "string", "key": "priceID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "67d2da07-cf6c-409d-b1ec-bfcbbb06f797", "name": "Gets all Prices", "request": { "name": "Gets all Prices", "description": { "content": "Allows you to retrieve all prices for a product, irrespective of the different price books that include that product's price. For example, you can filter for all prices for a specified `sku`, or filter for all prices changed before or after a given date. This will retrieve prices from all price books.\n\n### Filtering\n\nThis endpoint supports filtering. For general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\n| Operator | Attribute | Description | Example |\n| --- | --- | --- | --- |\n| `eq` | `external_ref`, `sku`, `id` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. | `filter=eq(sku,some-sku)` |\n| `in` | `external_ref`, `sku`, `id` | In. Checks if the values are included in the specified list. If they are, the condition is true. | `filter=in(sku,some-sku)` |\n| `like` | `external_ref`, `sku` | Like. Checks if the operand contains the specified string. Wildcards are supported. | `filter=like(sku,some-sku)` |\n| `gt` | `updated_at`, `created_at` | Greater than. Checks if the value on the left of the operator is greater than the value on the right. If it is, the condition is true. | `filter=gt(updated_at,2018-04-16T10:11:59.715Z)` |\n| `lt` | `updated_at`, `created_at` | Less than. Checks if the value on the left of the operator is less than the value on the right. If it is, the condition is true. | `filter=lt(updated_at,2018-04-16T10:11:59.715Z)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a8ccae85-bd3a-4fe6-b7b6-097fa1a51acd", "name": "The price list.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n },\n {\n \"type\": \"product-price\",\n \"attributes\": {\n \"sku\": \"product-sku-a\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"sales\": {\n \"summer\": {\n \"schedule\": {\n \"valid_form\": \"2023-12-24T09:00:00\",\n \"valid_to\": \"2023-12-25T09:00:00\"\n },\n \"currencies\": {\n \"USD\": {\n \"amount\": 90,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 40\n }\n }\n },\n \"CAD\": {\n \"amount\": 117,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 80\n }\n }\n },\n \"GBP\": {\n \"amount\": 65,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 50\n }\n }\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"admin_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n },\n \"shopper_attributes\": {\n \"cost_of_goods\": \"42.0\",\n \"charge_type\": \"credit card\"\n }\n },\n \"id\": \"a915553d-935d-4d56-870b-817b47a44a99\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\",\n \"pricebook_id\": \"4c45e4ec-26e0-4043-86e4-c15b9cf985a7\"\n }\n }\n ],\n \"meta\": {\n \"page\": {\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 0,\n \"total\": 1\n }\n },\n \"links\": {\n \"self\": \"https://BVwKGXJYCRlUOjwAawDYY.hnizb.QKo\",\n \"first\": \"https://RHiTczZKv.ztcIBV,Kqqd1oE\",\n \"prev\": \"https://KwSBKtyVVXzffPNWGQltXrLZKF.geWJperQWXJDwgnAlwNHVNzbuqkmoJz6.xBsJj5y4YyNSPtKAf0RQyYiQpUA\",\n \"next\": \"https://mi.befY9qmgpD3bZcIQR7Nyhmp2h5kSotaO8HiQe1\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "244d898a-11e8-47f9-a3a4-e3c2eb16000f", "name": "Unexpected error", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", "prices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Price Book Modifiers", "description": "You can use price modifiers to change the price property of child products. By default, child products inherit the same price as their base products. Using price modifiers, you can enable child products to inherit a different price. This enables you to configure the price of child products, for example, to be lower than its base product, without having to individually update the price of your child products. There are three types of price modifier.\n\n| Modifier | Data Type | Effect |\n|:------------------|:----------|:---------------------------------------------|\n| `price_increment` | `string` | Increases the price of a product. |\n| `price_decrement` | `string` | Decreases the price of a product. |\n| `price_equals` | `string` | Sets the price of a product to the amount you specify. |\n\nThe following is an overview of the steps you need to follow to use price modifiers.\n\n1. Create a price modifier. You must give the price modifier a unique name. For more information, see [Create a Price Modifier](/docs/api/pxm/pricebooks/create-price-modifier).\n1. Build your child products with the new product modifier.\n", "item": [ { "id": "ca93ae46-4944-43fb-b2e6-9df6ad9d9e29", "name": "Create a Modifier", "request": { "name": "Create a Modifier", "description": { "content": "You can use price modifiers to change the price property of child products. By default, child products inherit the same price as their base products. Using price modifiers, you can enable child products to inherit a different price. This enables you to configure the price of child products, for example, to be lower than its base product, without having to individually update the price of your child products. There are three types of price modifier.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3c61d691-6d95-4a8b-ade4-f3a2118fcf72", "name": "The created price modifier", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\"\n },\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://MyJSXYXcUGesNXhhhYqVlAHMQxUpqWrbo.tiwG,.SIRmzo+oONYOW6UXeulNR92nrAUAJ\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "376b3db2-9d44-434e-a5da-e5ef883ef444", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7bf2c6d5-aa45-43ad-86e3-da0f3ebb0151", "name": "Gets a list of all modifiers", "request": { "name": "Gets a list of all modifiers", "description": { "content": "Retrieves a list of price modifiers for the specified price book.\n\n### Filtering\n\nFiltering is supported on this endpoint. For the general syntax, see [Filtering](/guides/Getting-Started/filtering).\n\nYou can filter on the following attributes and operators.\n\n| Operator | Attribute | Description | Example |\n| --- | --- | --- | --- |\n| `eq` | `external_ref`, `name` | Checks if the values you provide matches a price modifier. | `filter=eq(name,largesupplement)` |\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ef7f3c62-e5b7-4f97-8445-2aa4b204ad35", "name": "The price modifier list.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\"\n },\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\"\n },\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\"\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 1\n },\n \"page\": {\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 0,\n \"total\": 1\n }\n },\n \"links\": {\n \"self\": \"https://EUTFNPaIdFvXlwuBthoElDPPhAB.ytort8dcI1WH.x.QFFwpBI.We9\",\n \"first\": \"http://VMe.prsQl7ydOHrAZvIHiX+YJSyxKe+uvhPcdR++fyVTv0sGniLcM7C2bxOBXtTLxcrlRC+\",\n \"last\": \"http://Kz.juWiFhQW4cwGj\",\n \"prev\": \"http://bHhoYkNSfmeAOavicrEcop.toaVW6tAfhyUwPM4b0hJMOMfgXgdL\",\n \"next\": \"http://WKwsikJeVPyHjeolUn.boRte7q3,ZNH+FVEDgUD36Gc9\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96579be1-ed2b-4463-ae7d-332eb65164c8", "name": "Unexpected error", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This endpoint supports filtering. See [Filtering]().\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "7788" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page offset is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "3686" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b1beac13-2660-4a74-8714-0d1f07a1c435", "name": "Get a Modifier", "request": { "name": "Get a Modifier", "description": { "content": "Retrieves the specified price book modifier from the specified price book.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "modifierID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c5fc7ea0-6dca-4057-8539-342df92a0d33", "name": "The price modifier.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\"\n },\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://MyJSXYXcUGesNXhhhYqVlAHMQxUpqWrbo.tiwG,.SIRmzo+oONYOW6UXeulNR92nrAUAJ\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd3f58eb-7c17-4638-8042-e463d4f68aac", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6efe1a84-1dea-4bd8-9b4b-a7debf2c14bd", "name": "Update a Modifier", "request": { "name": "Update a Modifier", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the price modifier is not updated.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "modifierID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7e81e477-bd3f-4d0b-93c2-53461a52697c", "name": "Updated price modifier.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"external_ref\": \"external-ref\",\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\"\n },\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"pricebook_external_ref\": \"a-pricebook-external-ref\",\n \"meta\": {\n \"owner\": \"store\"\n }\n },\n \"links\": {\n \"self\": \"http://MyJSXYXcUGesNXhhhYqVlAHMQxUpqWrbo.tiwG,.SIRmzo+oONYOW6UXeulNR92nrAUAJ\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f935c31-46d2-4f74-b17f-bbd4cb6eda2f", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"37f2eed6-0bea-4d0b-a3c6-24cc76143bfd\",\n \"type\": \"price-modifier\",\n \"attributes\": {\n \"currencies\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_5\": {\n \"minimum_quantity\": 5,\n \"amount\": 50\n }\n }\n },\n \"CAD\": {\n \"amount\": 127,\n \"includes_tax\": false,\n \"tiers\": {\n \"min_10\": {\n \"minimum_quantity\": 10,\n \"amount\": 100\n }\n }\n },\n \"GBP\": {\n \"amount\": 73,\n \"includes_tax\": true,\n \"tiers\": {\n \"min_20\": {\n \"minimum_quantity\": 20,\n \"amount\": 60\n }\n }\n }\n },\n \"name\": \"large-supplement\",\n \"modifier_type\": \"price_equals\",\n \"external_ref\": \"external-ref\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2866179a-a374-435e-855d-544afc41f86b", "name": "Delete a Modifier", "request": { "name": "Delete a Modifier", "description": { "content": "Deletes the specified price book modifier.", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "pricebookID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "modifierID", "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "e0310375-eec1-41e1-8d9e-1b118acbf36c", "name": "A 204 response indicates that the price modifiers have been deleted", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5b33f8e2-9a7e-45ae-a4e1-e9c035ba1679", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", ":pricebookID", "modifiers", ":modifierID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book", "type": "text/plain" }, "type": "any", "value": "string", "key": "pricebookID" }, { "disabled": false, "description": { "content": "(Required) Unique identifier of a Price Book Modifier", "type": "text/plain" }, "type": "any", "value": "string", "key": "modifierID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The modifier already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Import a Price Book and Prices", "description": "You can create and update product price books and prices in bulk, at both organization and store level, using the Price Book Import API. This is useful, for example, if you have a promotion and want to update 50,000 product prices. Rather than having to go to each price book and manually edit 50,000 prices, you can use the Price Book Import API to bulk update all your product prices at the same time, including setting different prices for different currencies.\n\nYou can create/update:\n\n- price books.\n- prices.\n - sales pricing for products and product bundles with SKUs.\n - volume pricing (tiers).\n\nThe following are not supported by the Price Book Import API:\n\n- price modifiers\n- SKUless bundles\n- Bundle sale prices\n\nThe API uses a [JSONL](https://jsonlines.org/) file. The JSONL file can be compressed to a GZIP file. Here is an [example of a JSONL file](/assets/example_file_all.jsonl).\n\nA file can include up to 50,000 objects. If you have more than 50,000 objects, then you must create a separate file, and import each file, one at a time.\n\n### Characteristics of Price Book Import\n\nThe Price Book Import API reads the entire file and then creates/updates the price book objects. This means the price book objects can be in any order in the file.\n\nPrice book imports are asynchronous. When you send a request to the price book import API, it triggers an asynchronous job to create/update the price books and product prices. You can see the status of a job using Get a job.\n\nJobs are processed one at a time. You can continue to send price book import requests, but those jobs are queued. In other words, Commerce looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed. See [Jobs](/docs/api/pxm/products/jobs).\n\nThe API works on a \"best endeavours\" approach. In other words, the API does its best to create/update the price book objects based on the file that you provide. You can then use the results of the job to understand what objects the API created/updated and to troubleshoot any errors. See [Price Book Import API Results](#price-book-import-api-results).\n\nPrice book imports are processed sequentially in the order that you send your import API requests.\n\n### Price Book Import Unique Identifiers\n\nThe API uses unique identifiers to identify the objects to be created/updated.\n\nYou must provide either an `id` or an `external_ref`. You may have both, but you must have at least one.\n\n- If you supply an `id` then the ID must exist for the object to be updated. If the ID does not exist, this causes an error.\n- If you supply an `external_ref` then the API checks if the external reference exists and updates the object. If the external reference does not exist, the API creates a new object with the external reference you have specified.\n\n#### Price Book Unique Identifiers\n\nThe following table describes the unique identifiers you must provide, depending on whether you are creating or updating a price book.\n\n| Action | Unique Identifiers |\n| --- | --- |\n| Creating |
  • Unique price book name.
  • `external_ref` for the price book.
|\n| Updating |
  • `id` and/or `external_ref` for the price book.
|\n\n#### Price Unique Identifiers\n\nThe following table describes the unique identifiers you must provide, depending on whether you are creating or updating a price.\n\n | Action | Unique Identifiers |\n | --- | --- |\n | Creating |
  • The product SKU that the price belongs to.
  • `id` and/or `external_ref` for the price book where you want to create the new price.
  • `external_ref` for the price. The `external_ref` for a price must be unique within a price book. However, you can have duplicate price external references across multiple price books.
|\n | Updating |
  • The product SKU that the price belongs to.
  • `pricebook_external_ref` for the price book where you want to update the new price.
  • `id` and/or `external_ref` for the price. The `external_ref` for a price must be unique within a price book. However, you can have duplicate price external references across multiple price books.
|\n \n ### Price Book Import File\n \n You can create/update price book objects using [Import a Price](/docs/api/pxm/pricebooks/import-a-price-book-and-prices).\n \n The API uses a [JSONL](https://jsonlines.org/) file. The JSONL file can be compressed to a GZIP file. Here is an [example of a JSONL file](/assets/example_file_all.jsonl).\n \n A file can include up to 50,000 objects. If you have more than 50,000 objects, then you must create a separate file, and import each file, one at a time.\n \n - The `pricebook` Object - The attributes you can specify for a `pricebook` object are the attributes you specify when [creating a pricebook](/docs/api/pxm/pricebooks/create-pricebook). \n \n - The `product-price` Object - The attributes you can specify for a `product-price` object are the attributes you specify when [adding a price to a price book](/docs/api/pxm/pricebooks/create-product-price).\n \n Once your import file is created, use the [import a price book and prices API to import](/docs/api/pxm/pricebooks/import-pricebook) the file.\n \n ### Importing product prices with custom attributes\n \n There are two types of custom attributes a price can have `shopper_attributes` and `admin_attributes`. When importing product prices with custom attributes, you can import a price with:\n \n - up to 100 `admin_attributes`\n - up to 100 `shopper_attributes`\n \n Ensure that a price adheres to these limits for custom attributes.\n \n ### Price Book Import API Results\n \n The API works on a \"best endeavours\" approach. In other words, the API does its best to create/update the price book objects based on the file that you provide.\n \n If there are any errors, then the import is aborted and the job fails with an error. You can then use the job results to understand what objects the API created/updated until the import failed and to troubleshoot any errors. \n \n Once you have fixed any errors, you can then use the [**import a price**](/docs/api/pxm/pricebooks/import-pricebook) endpoint to send the request again.\n \n The following table describes the import messages reported by the API.\n \n | Import Message | Description |\n | --- | --- |\n |
  • import price book_id: '%v' belongs to Organization\", price book.ID))
  • \"import price book external_ref: '%v' belongs to Organization\", *price book.ExternalRef)
| This group of messages tells you that these imported objects belong to an organization. \n |
  • matched price with pricebook_id - had different external_ref
  • matched price with pricebook_id - belongs to different price book
  • matched price with pricebook_id - price_id not found
  • matched price with pricebook_id - price_id belongs to an organization.
  • matched price with pricebook_id - duplicate external_ref detected
  • matched price with pricebook_id - duplicate SKU detected - required SKU.
| This group of messages is telling you that the price was updated but there is an issue with another attribute that requires fixing. |\n \n The following table describes the import errors reported by the API.\n \n | Error | Description |\n | --- | --- |\n |
  • error processing gzip file
  • error processing object '%v' invalid json provided
| This group of errors indicates that there is a problem with the JSONL file. You must fix the problems with the file and try the import again. |\n |
  • duplicate price book Id '%s' in imported price books
  • missing attributes for price book
  • invalid type for external_ref for price book
  • missing attributes for price
  • missing sku for price
  • missing sku for price
  • invalid type for external_ref for price
  • invalid type for sku for price
  • missing price book_id/price book_external_ref for price
  • price book id(s) not found
  • price book external ref(s) not found
  • price book id not found:
  • duplicate external ref found
  • price Ids not found
  • price book external refs not found
| This group of errors indicates that there is some information missing from the objects you are trying to create/update. |\n", "item": [ { "id": "7df61738-08f0-4259-8cee-3d3752154688", "name": "Import a Price", "request": { "name": "Import a Price", "description": { "content": "You can create and update product price books and prices in bulk, at both organization and store level, using the Price Book Import API. This is useful, for example, if you have a promotion and want to update 50,000 product prices. Rather than having to go to each price book and manually edit 50,000 prices, you can use the Price Book Import API to bulk update all your product prices at the same time, including setting different prices for different currencies.\n \n The API uses a [JSONL](https://jsonlines.org/) file. The JSONL file can be compressed to a GZIP file. Here is an [example of a JSONL file](/assets/example_file_all.jsonl).\n \n The API works on a \"best endeavours\" approach. In other words, the API does its best to create/update the price book objects based on the file that you provide. If there are any errors, then the import is aborted, and the job fails with an error. You can then use the job results to understand what objects the API created/updated until the import failed, and to troubleshoot any errors. See [Import Results](#tag/Price-Book-Import).\n \n Price book imports are processed sequentially in the order that you send your import API requests.\n", "type": "text/plain" }, "url": { "path": [ "pcm", "pricebooks", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": null }, "response": [ { "id": "483fd9bb-a899-49bd-8289-bca1a06cb164", "name": "The created price book", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"0dd4e7de-006f-460f-a43e-a581f375cedc\",\n \"attributes\": {\n \"created_at\": \"2020-09-22T09:00:00Z\",\n \"updated_at\": \"2020-09-22T09:00:00Z\",\n \"type\": \"pricebook-import\",\n \"status\": \"pending\",\n \"started_at\": \"2020-09-22T09:00:00Z\",\n \"completed_at\": \"2020-09-22T09:00:00Z\"\n },\n \"meta\": {\n \"x_request_id\": \"2d70776e-c2b0-4446-84e6-d08a24edfca4\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c514de3a-3187-470f-87af-5018927839eb", "name": "Unexpected error.", "originalRequest": { "url": { "path": [ "pcm", "pricebooks", "import" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n },\n {\n \"detail\": \"The price book already exists\",\n \"status\": \"409\",\n \"title\": \"conflict\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Promotions Standard", "description": "", "item": [ { "id": "4d2d54c5-9cae-4ac3-a57f-ae8330d4efd4", "name": "Get all Promotions", "request": { "name": "Get all Promotions", "description": { "content": "Returns all promotions.\n\n:::note\n\nYou can use pagination with this resource. For more information, see [pagination](/guides/Getting-Started/pagination).\n\n:::\n\n### Filtering\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](https://elasticpath.dev/guides/Getting-Started/filtering#supported-characters).\n\nUse `code` filter to search codes within promotions.\n\n| Attribute | Type | Operator | Example |\n|:-----|:---------|:---------|:----------------------------------------|\n| `code` | `string` | `eq` | `eq(code,some_code)` | \n\nFor filtering advanced promotion usages, pass the `EP-Public-Search-Type=cm_search` header. Advanced search filtering is only applicable when the promotion code is consumed and the promotion is not deleted.\n\n| Attribute | Type | Operator | Example |\n|:-----|:---------|:---------|:----------------------------------------|\n| `promo_id` | `string` | `eq`\t | `eq(promo_id, 69c63c9d-8ccf-44b1-8e98-1e7feebfb581)` |\n| `promo_name` |`string`\t | `eq`, `like`\t | `eq(promo_name,cart percent discount)` |\n| `promo_type` | `string`\t | `eq`\t | `eq(promo_type,fixed_discount)` |\n| `promo_status` | `string`\t | `eq`\t | `eq(promo_status,Running)` |\n| `promo_checkouts` | `string`\t | `eq`,`gt`, `ge`, `lt`, `le`\t | `eq(promo_checkouts,2)` |\n| `promo_skus_prod_ids` |\t`string`\t | `eq`, `like`\t | `eq(promo_skus_prod_ids, sku1)` |\n| `promo_start_date` |\t`string`\t| `eq`, `gt`, `gr`, `lt`, `le` | `eq(promo_start_date,2023-01-01)` |\n| `promo_end_date` |\t`string` | `eq`, `gt`, `gr`, `lt`, `le`\t | `eq(promo_end_date,2050-06-15)` |\n| `code_id`\t | `string` | `eq` | `eq(promo_id,2ea0cd1d-43a9-441b-b03f-3cab84aaee0c):eq(code_id,14b55e6c-3f80-436e-a90a-4de5f0e36240)` |\n| `code_code` | `string` | `eq`, `like` | \t`eq(code_code,cart_fixed_10)` |\n| `code_used`\t | `string` | `eq`, `gt`, `gr`, `lt`, `le`\t | `eq(code_used,2)` |\n| `code_created_date` |\t`string`\t| `eq`, `gt`, `gr`, `lt`, `le`\t | `eq(code_created_date,2023-11-15)` |\n| `order_id` |\t`string` | `eq`, `like`\t | `eq(order_id,ccb13673-627c-4976-88da-f77c542b528f)` |\n| `order_customer_email`\t | `string` | `eq`, `like`\t | `like(order_customer_email,andy*)` |\n| `order_created_date`\t | `string`\t| `eq`, `gt`, `gr`,`lt`, `le`\t | `le(order_created_date,2023-11-15)` | \n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "593d11d7-a883-4571-86f4-48785d445fb3", "name": "200", "originalRequest": { "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"e6cda419-ef87-21c9-4549-e1c1ae3f5875\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": true,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 3755,\n \"currency\": \"string\"\n },\n {\n \"amount\": 105,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 2381.0358188436844\n },\n {\n \"type\": \"string\",\n \"id\": \"41b1e050-c259-b33c-8ddd-9d40bba82d7f\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 709,\n \"currency\": \"string\"\n },\n {\n \"amount\": 2332,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 2256.697382815842\n }\n ],\n \"links\": {\n \"current\": \"string\",\n \"first\": \"string\",\n \"last\": \"string\",\n \"next\": \"string\",\n \"prev\": \"string\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 5729,\n \"limit\": 668,\n \"offset\": 6936,\n \"total\": 1895\n },\n \"results\": {\n \"total\": 2720\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba3f368e-b314-441e-b930-fe8af027f81a", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7460be74-2140-449a-b997-62948b12897e", "name": "Create a Promotion", "request": { "name": "Create a Promotion", "description": { "content": "You can use this endpoint to create the following types of promotion:\n - Cart Fixed Discount Promotion\n - Cart Percent Discount Promotion\n - X for Y Discount Promotion\n - X for Amount Discount Promotion\n - Fixed Bundle Discount Promotion\n - Item Fixed Discount Promotion\n - Item Percent Discount Promotion\n - Free Gift Promotion\n\n### The `schema` object\n\nPromotions are defined by schemas that are used internally to verify promotions and calculate discounts. You must define a schema when you create the promotion. For more information, see the schema.exclude criteria and the targeting fields criteria.\n\n#### The `schema.exclude` criteria\n\nWhen creating a promotion, you can specify when it **should not** be applied. The promotion will not be applied on any cart (or cart item, depending on the promotion type) that fulfills at least one of the `schema.exclude` criteria. The following criteria can be set to exclude items from a promotion:\n\n- `schema.exclude.targets`\n- `schema.exclude.nodes`\n- `schema.exclude.attributes`\n- `schema.exclude.conditions`\n\nFor example, if you want to create a promotion with value as *SKU1* in `schema.exclude.targets` and and color *yellow* and size *small* in `schema.exclude.attributes`, then any products with *SKU1* or the color *yellow* or the size *small* will be excluded from the promotion.\n\nTo exclude products from a promotion based on multiple conditions at the same time, use `schema.exclude.conditions`. For example, use `schema.exclude.conditions` to exclude items that are both *yellow* in color and *small* in size.\n\n#### The targeting fields criteria\n\nWhen creating a promotion, you can also specify when it **should** be applied. To define the targeted products, use the following fields:\n\n - `schema.target_catalogs`\n - `schema.targets`\n - `schema.target_nodes`\n - `schema.target_attributes`\n - `schema.target_conditions`\n\nThe cart item's catalog is verified if you define the `schema.target_catalogs` field. If the item is in any of the targeted catalogs specified in `schema.target_catalogs`, the promotion will be applied. If the item is not in any of the catalogs, the promotion will not be applied.\n\nThen, the cart item is verified to see if it fulfills at least one criteria of any of the four other targeting fields. In other words, the `schema` targeting fields such as `schema.targets`, `schema.target_nodes`, `schema.target_attributes` and `schema.target_conditions` create *OR* targeting conditions.\n\nFor example, if you create a promotion with values as *SKU1* in `schema.targets` and color *yellow* and size *small* in `schema.target_attributes`, then it will be applied to any products with *SKU1* or the color *yellow* or the size *small*.\n\nTo create a promotion that targets products based on multiple conditions at the same time, use `schema.target_conditions`. For example, use it to target items that are both *yellow* in color and *small* in size.\n\n:::note\n\nFor Cart Fixed Discount Promotion and Cart Percent Discount Promotion, the cart item's catalog is verified if you define the `schema.target_catalogs` field. If the item is in any of the targeted catalogs specified in `schema.target_catalogs`, the promotion will be applied. If the item is not in any of the catalogs, the promotion will not be applied.\n\n:::\n\n:::caution\n\n- Line-item discounts are only supported by the line calculation method. For more information about this method, see the Calculation Method section.\n- Hierarchy-based promotions are not supported for fixed bundle discount promotion and free gift promotion. To promote a bundle, create the bundle in Product Experience Manager, and then create a promotion for that bundle. For more information, see Bundles in Product Experience Manager.\n- For Free Gift Promotion, we recommend using `auto_add_free_gift` feature with `automatic` setting enabled. When `automatic` is set to `true`, it indicates that promotions are added automatically, and discounts are applied accordingly. If you enable the `auto_add_free_gift`, but do not enable the `automatic` setting, gift items will be added without discounts. In this case, shoppers need to apply coupon codes twice, first to add the gift item and then to apply the discount.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 1110,\n \"currency\": \"string\"\n },\n {\n \"amount\": 5548,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 8550.19859367556\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "d3c9a65e-3b8f-42b1-970c-e6a98f565bc7", "name": "201", "originalRequest": { "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 1110,\n \"currency\": \"string\"\n },\n {\n \"amount\": 5548,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 8550.19859367556\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fb18b7a7-3b08-25c7-444c-fc28f7e05b81\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 6524,\n \"currency\": \"string\"\n },\n {\n \"amount\": 1956,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 1648.5967118825529\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3519b987-9bc6-4164-b6bf-3783c977aec8", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 1110,\n \"currency\": \"string\"\n },\n {\n \"amount\": 5548,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 8550.19859367556\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "38b75118-7109-4683-ae7b-c51d3e37c5ef", "name": "Get a Promotion", "request": { "name": "Get a Promotion", "description": { "content": "Retrieves a promotion.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "77da6845-dc53-44a8-a313-15458cbf4cf3", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fb18b7a7-3b08-25c7-444c-fc28f7e05b81\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 6524,\n \"currency\": \"string\"\n },\n {\n \"amount\": 1956,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 1648.5967118825529\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fe45233-5e34-4a2e-b163-d881037e62ee", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56d94489-e135-4dfc-8a98-b0da6ce1b0b6", "name": "Update a Promotion", "request": { "name": "Update a Promotion", "description": { "content": "Use this endpoint to update a specific promotion.\n\n:::note\n\n You can re-enable an expired promotion by updating the end date to a future date. However, when you enable a promotion again, all codes previously attached to it are deleted to make sure that duplicate promotion codes do not exist on different promotions.\n\n:::\n\n### Errors\n\nWhen extending the end date of an expired promotion with over 1000 codes, you will receive the following error response. In such cases, we recommend duplicating the promotion, allowing you to set the new end dates and create promotion codes as needed.\n\n```json\n{\n \"errors\": [\n {\n \"status\": 422,\n \"source\": \"request\",\n \"title\": \"Unprocessable Entity\",\n \"detail\": \"\"\n }\n ]\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique promotion identifier.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 7438,\n \"currency\": \"string\"\n },\n {\n \"amount\": 2649,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 5924.164195284765\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "35382871-33a4-48cc-9947-86236ac6869c", "name": "200", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique promotion identifier.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 7438,\n \"currency\": \"string\"\n },\n {\n \"amount\": 2649,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 5924.164195284765\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fb18b7a7-3b08-25c7-444c-fc28f7e05b81\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 6524,\n \"currency\": \"string\"\n },\n {\n \"amount\": 1956,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 1648.5967118825529\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e494230f-be33-498b-9490-5850b86753c3", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique promotion identifier.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"string\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 7438,\n \"currency\": \"string\"\n },\n {\n \"amount\": 2649,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 5924.164195284765\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6c435f1d-f0a0-4577-af43-d0a3a0706988", "name": "Delete a Promotion", "request": { "name": "Delete a Promotion", "description": { "content": "Use this endpoint to delete a specific promotion.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The ID of the promotion that you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "7f0ad0ec-a439-4c5e-b34a-eda789226035", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5c772c28-1e27-4264-b9d7-4f145f2d821e", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "32a79633-e469-4069-ae12-19027c9e9911", "name": "Get a Promotion History", "request": { "name": "Get a Promotion History", "description": { "content": "Use this endpoint to retrieve a promotion history.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f928c921-57a5-4182-be8a-1ca3929b0b21", "name": "200", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"e6cda419-ef87-21c9-4549-e1c1ae3f5875\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": true,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 3755,\n \"currency\": \"string\"\n },\n {\n \"amount\": 105,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 2381.0358188436844\n },\n {\n \"type\": \"string\",\n \"id\": \"41b1e050-c259-b33c-8ddd-9d40bba82d7f\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": false,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 709,\n \"currency\": \"string\"\n },\n {\n \"amount\": 2332,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 2256.697382815842\n }\n ],\n \"links\": {\n \"current\": \"string\",\n \"first\": \"string\",\n \"last\": \"string\",\n \"next\": \"string\",\n \"prev\": \"string\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 5729,\n \"limit\": 668,\n \"offset\": 6936,\n \"total\": 1895\n },\n \"results\": {\n \"total\": 2720\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f9915e8-c117-4b7e-95dc-f664ece58773", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Promotion Codes", "description": "You can apply promotions automatically to all customer carts, or you can create promotion codes that customers must enter to receive the discount. You can enable this feature by setting the automatic attribute to `false` in the promotions schema when you create a promotion. For more information, see [Create Promotion Codes](/docs/api/promotions/create-promotion-codes).\n\nYou can generate and export codes for a promotion using the bulk code generation feature, which allows you to create a large number of unique codes and export them in CSV format. For details, refer to the [Generating Bulk Codes](/docs/commerce-manager/promotions-standard/overview#generating-bulk-codes) and [Managing Export Codes](/docs/commerce-manager/promotions-standard/overview#managing-code-export) sections.\n\nYou can generate a maximum of 1000 codes for a promotion. If you need to generate more than 1000 codes, limit the promotion's duration to a maximum of 365 days from its start date. The promotion expiry date is 365 days.\n\nWith the consume unit feature, you can limit the number of usages of a code for a promotion. You must create a code for this promotion to track the usage of the promotion. The consume unit options are `per_cart` and `per_item`. For example, consider a store that offers 50% off on *SKU1*, but limits the promotion to a maximum of two usages. Under the `per_cart` setting, a shopper can buy *SKU1* twice in a separate transaction, each at a 50% discount. However, with the `per_item` setting, if a shopper buys two SKU1s in a single purchase, both items count toward the promotion's usage limit. Therefore, the shopper would use up both usages of the promotion in a single purchase.\n\nPromotion codes can be group codes or individual codes. For example, you can offer a seasonal discount to all customers, such as *SUMMER-SALE*, or you can offer preferred customers unique discount codes. Promotion codes expire automatically at the end of the promotion period and are removed from the promotion.\n\nWhen a promotion expires, the promotion codes attached to the promotion automatically become invalid. However, when you re-enable the expired promotion, the promotion codes attached to the promotion are deleted.\n\nWhen you checkout a cart with an expired promotion, the expired promotion will be automatically removed from a cart and the checkout process is initiated. As a best practice, we recommend to update your cart to remove the expired promotion before initiating the checkout process.\n\nWhen extending the end date of an expired promotion with over 1000 codes, you will receive an error response. See [Update a Promotion](/docs/api/promotions/update-a-promotion). In such cases, we recommend [duplicating the promotion](/docs/commerce-manager/promotions-standard/overview#duplicating-promotions), allowing you to set the new end dates and create promotion codes as needed.\n", "item": [ { "id": "738946dc-ea71-450c-9e41-6b4cc77af3b3", "name": "Get Promotion Codes", "request": { "name": "Get Promotion Codes", "description": { "content": "You can use this endpoint to retrieve promotion codes. \n\n:::note\n- The `codes.max_uses` attribute represents the maximum usage of the codes. \n- The `codes.uses` attribute represents the remaining number of times the codes can be used for the promotion.\n- Codes created before April 27, 2023 will only have `codes.uses` attribute in the response body.\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. Promotion codes are case-insensitive.\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------- |:---------|:------------|:---------------|\n| `code` | `string`, `number` | `eq`, `gt` | `eq(code,summer2024)`, `gt(code,2024)` |\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "921f7bc8-92af-4b74-a5f3-be40519e54a5", "name": "200", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. Promotion codes are case-insensitive.\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------- |:---------|:------------|:---------------|\n| `code` | `string`, `number` | `eq`, `gt` | `eq(code,summer2024)`, `gt(code,2024)` |\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"data\": {\n \"codes\": [\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 1505.868090928364,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\"\n }\n }\n },\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 2513.515083308664,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\"\n }\n }\n }\n ]\n }\n },\n {\n \"data\": {\n \"codes\": [\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 8001.648108169961,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\"\n }\n }\n },\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 9720.730427295226,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-11-07T23:04:18.845Z\"\n }\n }\n }\n ]\n }\n }\n ],\n \"links\": {\n \"current\": \"string\",\n \"first\": \"string\",\n \"last\": \"string\",\n \"next\": \"string\",\n \"prev\": \"string\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 1103,\n \"limit\": 2997,\n \"offset\": 3141,\n \"total\": 1983\n },\n \"results\": {\n \"total\": 9397\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66727d76-992c-49a5-b812-b274c5b86b7a", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. Promotion codes are case-insensitive.\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------- |:---------|:------------|:---------------|\n| `code` | `string`, `number` | `eq`, `gt` | `eq(code,summer2024)`, `gt(code,2024)` |\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8c3901c5-538b-4789-bbb5-cd805f45a957", "name": "Create Promotion Codes", "request": { "name": "Create Promotion Codes", "description": { "content": "Use this endpoint to create promotion codes for a specific promotion.\n\n:::note\n\nWhen a promotion expires, the promotion codes attached to the promotion automatically become invalid. However, when you re-enable the expired promotion, the promotion codes attached to the promotion are deleted.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codes\": [\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 5304.319612964648\n },\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 2016.3712900298658\n }\n ],\n \"type\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "c18bd2e6-4468-4ef0-ab99-f5ed2a36ba6a", "name": "201", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codes\": [\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 5304.319612964648\n },\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 2016.3712900298658\n }\n ],\n \"type\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"id\": \"fb18b7a7-3b08-25c7-444c-fc28f7e05b81\",\n \"name\": \"string\",\n \"description\": \"string\",\n \"automatic\": true,\n \"enabled\": false,\n \"promotion_type\": \"item_percent_discount\",\n \"schema\": {\n \"currencies\": [\n {\n \"amount\": 6524,\n \"currency\": \"string\"\n },\n {\n \"amount\": 1956,\n \"currency\": \"string\"\n }\n ],\n \"target_catalogs\": [\n \"string\",\n \"string\"\n ],\n \"conditions\": {\n \"or\": [\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n },\n {\n \"and\": [\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n },\n {\n \"attribute\": {\n \"template\": \"string\",\n \"field\": \"string\",\n \"type\": \"string\",\n \"value\": \"string\"\n }\n }\n ]\n }\n ]\n }\n },\n \"start\": \"string\",\n \"end\": \"string\",\n \"min_cart_value\": {},\n \"max_applications_per_cart\": 1648.5967118825529\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8579ad7c-810e-4061-95c1-86d9db527cd5", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codes\": [\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 5304.319612964648\n },\n {\n \"code\": \"string\",\n \"consume_unit\": \"string\",\n \"user\": \"string\",\n \"uses\": 2016.3712900298658\n }\n ],\n \"type\": \"string\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3145a8dc-fbd1-47bc-a5d3-cfb59dcb5695", "name": "Delete Multiple Promotion Codes", "request": { "name": "Delete Multiple Promotion Codes", "description": { "content": "Use this endpoint to delete multiple promotion codes within a specific promotion.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The ID of the promotion associated with the codes.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "0c0cb983-8e88-4453-b2e7-176da3de7616", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "84488b1f-38fe-4d41-a196-3b628fe9ee95", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9905150e-6c06-4bf6-a1ff-13af1821be9c", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"detail\": \"promotion not found\",\n \"status\": 404,\n \"title\": \"Not Found\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d86086b-3241-4911-ad33-e555cd7a9008", "name": "Delete a Promotion Code", "request": { "name": "Delete a Promotion Code", "description": { "content": "Use this endpoint to delete a single promotion code.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "codes", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of the promotion associated with the codes.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "code", "disabled": false, "description": { "content": "(Required) Specifies the code that you want to delete.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "44c126ef-4ecb-42b5-b4a7-c27344bc1d94", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) Specifies the code that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c497da5e-eb6f-4575-91ff-782380811b37", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) Specifies the code that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51d2b970-c9fb-47f8-a4c9-e449c34e4d7c", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "codes", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Specifies the unique identifier of the promotion associated with the codes.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) Specifies the code that you want to delete.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"errors\": [\n {\n \"detail\": \"promotion not found\",\n \"status\": 404,\n \"title\": \"Not Found\"\n }\n ]\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Promotion Jobs", "description": "Use Jobs API to initiate a job within a promotion. Jobs operate asynchronously and have a different status based on their progress. The following are the job statuses:\n\n- `pending`: Commerce has received the request but is currently busy processing other requests.\n- `processing`: Commerce has initiated processing the job.\n- `completed`: The job is successfully completed.\n- `failed`: The job has failed.\n- `cancelling`: The job is currently in the process of being canceled. You need to wait for the cancellation process to complete. This occurs prior to the `cancelled` status. For example, if you cancel a big `code_generate` job, it may take some time for the cancellation to complete since part of the cancellation process involves deleting the generated codes.\n- `cancelled` : The job request is canceled.\n\n![Promotion Job Statuses Workflow](/assets/job_status_workflow.png)\n\n### Characteristics of Jobs\n\n- You can only initiate one job at a time within a promotion. If you want to run another job for the same promotion, you must wait until the previous job is `completed` or `failed`. However, you can create new jobs for different promotions even if there are `pending` jobs in other promotions.\n- If you intend to manage promotions with more than 10,000 codes per promotion, we recommend [exporting codes](/docs/api/promotions/create-a-promotion-job) for viewing purposes instead of attempting to view them within Commerce Manager. This recommendation is made due to our enforced maximum page offset limit of 10,000. Altering the page_offset_limit value poses potential performance risks to the platform.\n- A `code_generate` job is initiated even if the maximum allowable number of codes for the promotion has been reached. However, when processed, this job will fail. To view the status of this failed job, you can only do so by passing [GET Jobs](/docs/api/promotions/get-promotion-jobs) request.\n- A limited number of jobs can be processed at a time. Jobs are queued and processed sequentially, one after the other. You can expect a certain delay before job processing.\n", "item": [ { "id": "e844c2bd-49b1-44bf-b9bf-a55859b9a927", "name": "Get Promotion Jobs", "request": { "name": "Get Promotion Jobs", "description": { "content": "Retrieves the list of jobs for a specific promotion.\n\nIn the response example, you can see the `result.generated` field, which indicates the number of codes generated during the job processing. Additionally, you may also see the optional `result.deleted` field, indicating the number of codes deleted during the job cancellation. The parameters and result objects are shown only when `job_type` is `code_generate`.\n\n### Filtering\n\nThe following operators and attributes are available when filtering on this endpoint.\n\n| Attribute | Type | Operator | Example |\n| ----------| ----- | -------- | ------ |\n| `job_type` | `string` | `eq` | `eq(job_type, code_export)` |\n| `status` | `string` | `eq` | `eq(status, complete)` |\n\n### Errors\n\nIf an error occurs during job processing, the response includes an optional error field. For example, when you `GET` promotion jobs, the following response shows the details within the error field if an error occurred during job processing.\n\n ```json\n{\n \"data\": [\n {\n \"type\": \"promotion_job\",\n \"id\": \"84d86114-a92d-4c34-92f1-3e36ef6cabeb\",\n \"promotion_id\": \"ad386702-e780-42c6-b190-0527ad768917\",\n \"job_type\": \"code_generate\",\n \"name\": \"job\",\n \"parameters\": {\n \"number_of_codes\": 1000,\n \"consume_unit\": \"per_cart\",\n \"max_uses_per_code\": 1,\n \"code_length\": 8,\n \"code_prefix\": \"promo-\"\n },\n \"status\": \"failed\",\n \"error\": \"codes limit exceeded\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2023-12-06T13:52:29.587Z\",\n \"updated_at\": \"2023-12-06T13:54:49.133Z\"\n }\n }\n }\n ],\n \"links\": {\n \"current\": \"https://useast.api.elasticpath.com/v2/promotions/ad386702-e780-42c6-b190-0527ad768917/jobs?page[offset]=0&page[limit]=25\",\n \"first\": \"https://useast.api.elasticpath.com/v2/promotions/ad386702-e780-42c6-b190-0527ad768917/jobs?page[offset]=0&page[limit]=25\",\n \"last\": \"https://useast.api.elasticpath.com/v2/promotions/ad386702-e780-42c6-b190-0527ad768917/jobs?page[offset]=0&page[limit]=25\",\n \"prev\": \"https://useast.api.elasticpath.com/v2/promotions/ad386702-e780-42c6-b190-0527ad768917/jobs?page[offset]=0&page[limit]=25\",\n \"next\": \"https://useast.api.elasticpath.com/v2/promotions/ad386702-e780-42c6-b190-0527ad768917/jobs?page[offset]=0&page[limit]=25\"\n },\n \"meta\": {\n \"page\": {\n \"limit\": 25,\n \"offset\": 0,\n \"current\": 1,\n \"total\": 1\n },\n \"results\": {\n \"total\": 1\n }\n }\n}\n```\n", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "42369c20-7779-4dbb-955f-b59d508eae7a", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"string\",\n \"type\": \"promotion_job\",\n \"promotion_id\": \"string\",\n \"job_type\": \"string\",\n \"name\": \"string\",\n \"parameters\": {},\n \"status\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"1977-11-27T04:03:23.024Z\",\n \"updated_at\": \"1961-06-24T05:15:26.645Z\"\n }\n }\n },\n {\n \"id\": \"string\",\n \"type\": \"promotion_job\",\n \"promotion_id\": \"string\",\n \"job_type\": \"string\",\n \"name\": \"string\",\n \"parameters\": {},\n \"status\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2022-11-07T05:28:46.832Z\",\n \"updated_at\": \"2012-05-19T17:21:11.217Z\"\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "69e95f0b-136b-4b26-b378-d6be5bff8179", "name": "Create a Promotion Job", "request": { "name": "Create a Promotion Job", "description": { "content": "Use this endpoint to create an asynchronous job to generate codes and export promotion codes.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"promotion_job\",\n \"job_type\": \"code_generate\",\n \"name\": \"Summer Sale Job\",\n \"parameters\": {\n \"number_of_codes\": 1,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_cart\",\n \"code_prefix\": \"Summer-\",\n \"code_length\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5e11743b-54a9-4728-88fa-f7d432490a0b", "name": "Promotion job created", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"promotion_job\",\n \"job_type\": \"code_generate\",\n \"name\": \"Summer Sale Job\",\n \"parameters\": {\n \"number_of_codes\": 1,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_cart\",\n \"code_prefix\": \"Summer-\",\n \"code_length\": 10\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"type\": \"promotion_job\",\n \"promotion_id\": \"string\",\n \"job_type\": \"string\",\n \"name\": \"string\",\n \"parameters\": {},\n \"status\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2011-11-04T20:22:02.378Z\",\n \"updated_at\": \"1966-07-12T21:58:33.369Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1c6bfde1-fa31-4735-adc2-4c456365c113", "name": "Cancel a Job", "request": { "name": "Cancel a Job", "description": { "content": "Cancels an asynchronous job whose status is pending or processing.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "jobID", "disabled": false, "description": { "content": "(Required) The unique identifier of a job to be canceled.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1ad96aa4-121a-47f7-9246-aa76ea84009e", "name": "Job canceled successfully", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "jobs", ":jobID", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a job to be canceled.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"string\",\n \"type\": \"promotion_job\",\n \"promotion_id\": \"string\",\n \"job_type\": \"string\",\n \"name\": \"string\",\n \"parameters\": {},\n \"status\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2011-11-04T20:22:02.378Z\",\n \"updated_at\": \"1966-07-12T21:58:33.369Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8c1f3348-07f8-4bc2-9f42-255c4ce9b8f0", "name": "Get Promotion Code Exported File", "request": { "name": "Get Promotion Code Exported File", "description": { "content": "Retrieves exported codes in a CSV format.", "type": "text/plain" }, "url": { "path": [ "v2", "promotions", ":promotionID", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "jobID", "disabled": false, "description": { "content": "(Required) The unique identifier of a job associated with the file.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "347bd519-5ae1-42ad-9475-257044b85459", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "promotions", ":promotionID", "jobs", ":jobID", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of a job associated with the file.", "type": "text/plain" }, "type": "any", "value": "string", "key": "jobID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"href\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rule Promotions", "description": "", "item": [ { "id": "e421fba4-38fa-4a60-9ddf-7049bdf80ba5", "name": "Create a Rule Promotion", "request": { "name": "Create a Rule Promotion", "description": { "content": "Creates a new rule-based promotion, allowing flexible discount strategies based on cart or item conditions. \nPromotions can apply fixed or percentage-based discounts, apply automatically or via codes, and have eligibility rules \nbased on product attributes, cart total, SKU conditions, custom attributes, and more.\n\nThis endpoint supports a variety of promotion types, such as:\n- **Cart-wide discounts**\n- **Item-specific discounts**\n- **Shipping discounts**\n- **Combinations thereof**\n\n:::note\n\nThe minimum item discount amount is zero, both for amounts and percentages.\n\nA store can have a maximum of **50 active and future automatic rule promotions**.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"Cart 20% discount when total is at least $100\",\n \"description\": \"20% discount applying to the cart total\",\n \"enabled\": false,\n \"automatic\": false,\n \"start\": \"2024-01-01\",\n \"end\": \"2025-01-01\",\n \"rule_set\": {\n \"rules\": {\n \"strategy\": \"cart_total\",\n \"operator\": \"gte\",\n \"args\": [\n 10000\n ]\n },\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 20\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5875ad81-e3c8-4c9e-9e3a-29dcbf085345", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"Cart 20% discount when total is at least $100\",\n \"description\": \"20% discount applying to the cart total\",\n \"enabled\": false,\n \"automatic\": false,\n \"start\": \"2024-01-01\",\n \"end\": \"2025-01-01\",\n \"rule_set\": {\n \"rules\": {\n \"strategy\": \"cart_total\",\n \"operator\": \"gte\",\n \"args\": [\n 10000\n ]\n },\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 20\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "null", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "268b5bd3-7cfd-43b8-b70d-20f853b23fca", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"Cart 20% discount when total is at least $100\",\n \"description\": \"20% discount applying to the cart total\",\n \"enabled\": false,\n \"automatic\": false,\n \"start\": \"2024-01-01\",\n \"end\": \"2025-01-01\",\n \"rule_set\": {\n \"rules\": {\n \"strategy\": \"cart_total\",\n \"operator\": \"gte\",\n \"args\": [\n 10000\n ]\n },\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 20\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"400\",\n \"title\": \"Too many automatic rule promotions\",\n \"detail\": \"Only 50 active automatic rule promotions are allowed per store\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "202cfa9a-4d80-450c-b477-1397a0ec5a3e", "name": "Duplicate Priority", "originalRequest": { "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"Cart 20% discount when total is at least $100\",\n \"description\": \"20% discount applying to the cart total\",\n \"enabled\": false,\n \"automatic\": false,\n \"start\": \"2024-01-01\",\n \"end\": \"2025-01-01\",\n \"rule_set\": {\n \"rules\": {\n \"strategy\": \"cart_total\",\n \"operator\": \"gte\",\n \"args\": [\n 10000\n ]\n },\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 20\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 7932,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n },\n {\n \"status\": 2534,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8d55c35a-a013-496e-aade-93859f125f67", "name": "Get Rule Promotions", "request": { "name": "Get Rule Promotions", "description": { "content": "Retrieves a list of rule-based promotions, including information such as discount type, eligibility criteria, \nand configuration details. This endpoint supports filtering to refine results based on specific promotion attributes.\n\nUse query parameters to filter promotions by:\n- **Code** – Retrieve a specific promotion by its code.\n- **Promotion name** – Search for promotions by name.\n- **Activation status** – Filter by whether a promotion is active or not.\n- **Stackability** – Identify promotions that can or cannot be combined with others.\n- **Start and end dates** – Retrieve promotions based on their validity periods.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. \n\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------------------------|:-------------------|:-----------------------------|:----------------------------------------------------------------------|\n| `code` | `string`, `number` | `eq` | `eq(code,summer2024)` |\n| `name` | `string` | `like`,`ilike` | `ilike(name,'Summer *')` |\n| `enabled` | `boolean` | `eq` | `eq(enabled, true)` |\n| `stackable` | `boolean` | `eq` | `eq(stackable, true)` |\n| `override_stacking` | `boolean` | `eq` | `eq(override_stacking, true)` |\n| `start` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `gt(start, 2025-01-01T00:00:00.000Z)` |\n| `end` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `lt(end, 2025-01-01T00:00:00.000Z)` |\n| `rule_set.rules.strategy` | `string` | `eq`, `in` | `eq(rule_set.rules.strategy,account_tags)` |\n| `rule_set.rules.args` | `string` | `contains` | `contains(rule_set.rules.args, 11111111-1111-4111-1111-111111111111)` |\n| `account_tags` | `string` | `contains` | `contains(account_tags, 11111111-1111-4111-1111-111111111111)` |\n\nSome notes about filters:\n1. The `code` filter is case-insensitive. You can search for codes using only `numbers` or codes containing both `string` and `numbers`.\n2. The `rule_set.rules.*` filters do not search child conditions at present \n3. The `account_tags` filter will essentially search for any rule or child rule that has an `account_tags` strategy and the associated accounts.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2237add2-f5c3-42ba-a730-cf1489aeb65b", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. \n\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------------------------|:-------------------|:-----------------------------|:----------------------------------------------------------------------|\n| `code` | `string`, `number` | `eq` | `eq(code,summer2024)` |\n| `name` | `string` | `like`,`ilike` | `ilike(name,'Summer *')` |\n| `enabled` | `boolean` | `eq` | `eq(enabled, true)` |\n| `stackable` | `boolean` | `eq` | `eq(stackable, true)` |\n| `override_stacking` | `boolean` | `eq` | `eq(override_stacking, true)` |\n| `start` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `gt(start, 2025-01-01T00:00:00.000Z)` |\n| `end` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `lt(end, 2025-01-01T00:00:00.000Z)` |\n| `rule_set.rules.strategy` | `string` | `eq`, `in` | `eq(rule_set.rules.strategy,account_tags)` |\n| `rule_set.rules.args` | `string` | `contains` | `contains(rule_set.rules.args, 11111111-1111-4111-1111-111111111111)` |\n| `account_tags` | `string` | `contains` | `contains(account_tags, 11111111-1111-4111-1111-111111111111)` |\n\nSome notes about filters:\n1. The `code` filter is case-insensitive. You can search for codes using only `numbers` or codes containing both `string` and `numbers`.\n2. The `rule_set.rules.*` filters do not search child conditions at present \n3. The `account_tags` filter will essentially search for any rule or child rule that has an `account_tags` strategy and the associated accounts.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "null", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd4cfdbb-a2b6-4c5a-9b83-107bd2c12fe2", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. \n\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------------------------|:-------------------|:-----------------------------|:----------------------------------------------------------------------|\n| `code` | `string`, `number` | `eq` | `eq(code,summer2024)` |\n| `name` | `string` | `like`,`ilike` | `ilike(name,'Summer *')` |\n| `enabled` | `boolean` | `eq` | `eq(enabled, true)` |\n| `stackable` | `boolean` | `eq` | `eq(stackable, true)` |\n| `override_stacking` | `boolean` | `eq` | `eq(override_stacking, true)` |\n| `start` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `gt(start, 2025-01-01T00:00:00.000Z)` |\n| `end` | `date` | `lt`, `le`, `eq`, `gt`, `ge` | `lt(end, 2025-01-01T00:00:00.000Z)` |\n| `rule_set.rules.strategy` | `string` | `eq`, `in` | `eq(rule_set.rules.strategy,account_tags)` |\n| `rule_set.rules.args` | `string` | `contains` | `contains(rule_set.rules.args, 11111111-1111-4111-1111-111111111111)` |\n| `account_tags` | `string` | `contains` | `contains(account_tags, 11111111-1111-4111-1111-111111111111)` |\n\nSome notes about filters:\n1. The `code` filter is case-insensitive. You can search for codes using only `numbers` or codes containing both `string` and `numbers`.\n2. The `rule_set.rules.*` filters do not search child conditions at present \n3. The `account_tags` filter will essentially search for any rule or child rule that has an `account_tags` strategy and the associated accounts.\n", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 7932,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n },\n {\n \"status\": 2534,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ddea758f-8f41-4e90-b11f-8468d9306994", "name": "Get a Rule Promotion by ID", "request": { "name": "Get a Rule Promotion by ID", "description": { "content": "Retrieves a single Rule Promotion by the promotion ID. Responses include promotion specifications such as discount type, eligibility criteria, and configuration details.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4ee66647-5460-4c92-9d19-e39e01a027ba", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "null", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a9b9c58-a219-4c08-b11a-f91a2147e1dd", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 7932,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n },\n {\n \"status\": 2534,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6407477c-8f31-45ca-a204-5d7f482bdaf0", "name": "Update a Rule Promotion", "request": { "name": "Update a Rule Promotion", "description": { "content": "Updates an existing Rule Promotion specified by its promotion ID. This includes both **semantic and syntactic validation** to ensure correctness. For example, the start date must be earlier than the end date.\n\nEditable fields include:\n- `name`\n- `description`\n- `enabled`\n- `start`\n- `end`\n- `automatic`\n- `stackable`\n- `override_stacking`\n- `rule_set`\n\n:::note\n\nWhen updating the `automatic` field from `false` to `true`, the store must not exceed the maximum limit of **50 active and future automatic rule promotions**.\n\n:::\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion to be updated.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"$10 off cart rule - updated\",\n \"description\": \"updated cart rule $10 off your order!\",\n \"enabled\": false,\n \"automatic\": false,\n \"rule_set\": {\n \"rules\": [\n {\n \"strategy\": \"cart_total\",\n \"operator\": \"lt\",\n \"args\": [\n 1000\n ]\n }\n ],\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 10\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e5a276b5-b31d-49ff-99dd-a3156dc62fc0", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion to be updated.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"$10 off cart rule - updated\",\n \"description\": \"updated cart rule $10 off your order!\",\n \"enabled\": false,\n \"automatic\": false,\n \"rule_set\": {\n \"rules\": [\n {\n \"strategy\": \"cart_total\",\n \"operator\": \"lt\",\n \"args\": [\n 1000\n ]\n }\n ],\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 10\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "null", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e803c2ed-2ce3-443a-a5db-f9caa2071604", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion to be updated.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"$10 off cart rule - updated\",\n \"description\": \"updated cart rule $10 off your order!\",\n \"enabled\": false,\n \"automatic\": false,\n \"rule_set\": {\n \"rules\": [\n {\n \"strategy\": \"cart_total\",\n \"operator\": \"lt\",\n \"args\": [\n 1000\n ]\n }\n ],\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 10\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"400\",\n \"title\": \"Too many automatic rule promotions\",\n \"detail\": \"Only 50 active and future automatic rule promotions are allowed per store\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbca98a7-e79a-4915-aaad-26f76cf82168", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion to be updated.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"rule_promotion\",\n \"name\": \"$10 off cart rule - updated\",\n \"description\": \"updated cart rule $10 off your order!\",\n \"enabled\": false,\n \"automatic\": false,\n \"rule_set\": {\n \"rules\": [\n {\n \"strategy\": \"cart_total\",\n \"operator\": \"lt\",\n \"args\": [\n 1000\n ]\n }\n ],\n \"actions\": [\n {\n \"strategy\": \"cart_discount\",\n \"args\": [\n \"percent\",\n 10\n ]\n }\n ]\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ef3389e6-5dd5-4c3b-8ccd-70c08e743127", "name": "Delete a Rule Promotion", "request": { "name": "Delete a Rule Promotion", "description": { "content": "Deletes an existing Rule Promotion identified by its promotion ID.\n\n- This action **permanently removes** the promotion and cannot be undone.\n- If the promotion is active, please ensure that its removal does not impact ongoing campaigns.\n\nA successful request returns a `204 No Content` response, indicating that the promotion has been deleted.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ad772e3d-24da-4511-bae3-324a2ec45f73", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rule Promotion Codes", "description": "", "item": [ { "id": "d3dad54f-8331-43fa-a607-361a3a7c7336", "name": "Create Rule Promotion Codes", "request": { "name": "Create Rule Promotion Codes", "description": { "content": "Creates new promotion codes for a specific rule promotion, allowing customers to redeem discounts based on predefined conditions.\n\n- Supports bulk creation of multiple promotion codes in a single request.\n- Each code can have individual usage limits.\n- Can optionally assign codes to specific users to enforce targeted promotions.\n- The promotion codes are case-insensitive.\n\n:::note\n\nRegarding first time shopper limitations:\n- Orders without payment transactions do not count as completed purchases.\n- Canceling or refunding an order does not reinstate first-time shopper status.\n- A first-time shopper coupon code cannot have limited uses or be assigned to specific users, meaning the code cannot be restricted by the number of times it can be used or tied to a specific customer ID.\n\n:::\n\nA successful request returns a `201 Created` response with details of the generated promotion codes.\n\n### Duplicate Codes\nDuplicate promotion codes **are supported across different promotions** in the store, regardless of their statuses and validity dates. However, **duplicate codes cannot be created within the same promotion**.\nThis means that shoppers can apply a single coupon code to trigger multiple promotions if those promotions share common coupon codes. \n\nCodes that share the same name can serve different purposes. For example, one code may have `per_application` with a limited number of uses, while another identical code can have `per_checkout` with unlimited use.\n\n**Duplicate Code Handling:**\n- If a duplicate code is detected **within the same promotion**, the request will return a `422 Duplicate code` error.\n- When creating duplicate codes, a message appears with the successful response indicating the duplication.\n\n\nPlease refer to the **OpenAPI examples** section on this page for sample request structures.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4bd12e7d-f810-4f04-9629-ce4880904fa5", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"8a1c73bc-7c15-41c3-a3ed-a0aa398c3984\",\n \"code\": \"one_per_shopper\",\n \"user\": \"5abb8d4e-57c0-459b-91d5-c4e6f77e9c5e\",\n \"max_uses_per_shopper\": {\n \"max_uses\": 1,\n \"includes_guests\": false\n },\n \"consume_unit\": \"per_checkout\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5db3b819-772a-4783-832c-b16ac29222d3", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"source\": \"data.codes.0.max_uses_per_shopper\",\n \"title\": \"missing_dependency\",\n \"detail\": \"Has a dependency on max_uses\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20e8b8d2-49f4-4933-b3ec-e1d90683c5f1", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"422\",\n \"source\": \"\",\n \"title\": \"Unsupported consume unit\",\n \"detail\": \"Consume unit 'per_application' is not supported when using 'max_uses_per_shopper' features.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e68d70a4-b61a-489e-bcdb-ec7d933d80c5", "name": "Get Rule Promotion Codes", "request": { "name": "Get Rule Promotion Codes", "description": { "content": "Retrieves the list of promotion codes associated with a specific Rule Promotion.\n\n- Returns all codes generated for the given promotion ID, including details on usage limits and redemption status.\n- Supports both automatically generated and manually created promotion codes.\n- Can be used to verify whether a promotion code is still valid or has reached its usage limit.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. Promotion codes are case-insensitive.\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------- |:---------|:------------|:---------------|\n| `code` | `string`, `number` | `eq`, `gt` | `eq(code,summer2024)`, `gt(code,2024)` |\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order of the codes that will be returned.\n (This can only be one of code,-code)", "type": "text/plain" }, "key": "sort", "value": "code" } ], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ec946d94-8d36-4521-bbd4-2bd3fd41c42a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "This parameter accepts a filtering expression that uses specific operators and attributes. Promotion codes are case-insensitive.\n\nThe following operators and attributes are available when filtering on this endpoint. See [Supported Filtering Characters](/guides/Getting-Started/filtering#supported-characters).\n\n| Attribute | Type | Operator | Example |\n|:--------- |:---------|:------------|:---------------|\n| `code` | `string`, `number` | `eq`, `gt` | `eq(code,summer2024)`, `gt(code,2024)` |\n", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order of the codes that will be returned.\n (This can only be one of code,-code)", "type": "text/plain" }, "key": "sort", "value": "code" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"string\",\n \"id\": \"7f52d89a-5509-c65c-8506-7f8e691e7d1b\",\n \"code\": \"string\",\n \"uses\": 5050,\n \"user\": \"string\",\n \"consume_unit\": \"per_checkout\",\n \"max_uses\": 8538,\n \"max_uses_per_shopper\": {\n \"max_uses\": 7513,\n \"includes_guests\": false\n },\n \"is_for_new_shopper\": false,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"1949-06-14T16:54:59.242Z\"\n }\n }\n },\n {\n \"type\": \"string\",\n \"id\": \"54b89ea0-d45a-0399-aea9-bd0747d7b602\",\n \"code\": \"string\",\n \"uses\": 478,\n \"user\": \"string\",\n \"consume_unit\": \"per_checkout\",\n \"max_uses\": 9444,\n \"max_uses_per_shopper\": {\n \"max_uses\": 1348,\n \"includes_guests\": false\n },\n \"is_for_new_shopper\": true,\n \"created_by\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2024-07-14T06:06:41.987Z\"\n }\n }\n }\n ],\n \"links\": {\n \"current\": \"http://zkXdPUTnOnnFvlXkLII.dmikVc,GDzgQHn.cuec8dB4kJdfKI02z2qjtHvVG6ci3110x0vIb\",\n \"first\": \"https://iNPzLDOmOYwQLEUiCdigksHhawx.rocBTvCNmp0z3PstJM+-Q5TUZte85dSoLP90L1Zg\",\n \"last\": \"https://vFlyKpkeI.efTaxfCH2V1lkYFCeCziEyUrRsjCZYco92AVjaJT\",\n \"next\": \"http://wPWyUSsjafXCjQqKbshTn.fjdA.YvtjjnuIFaWzmWoE158hHKZCKoSOSAvzyS7\",\n \"prev\": \"http://jRwjnzBlYRgkNcDCojtkWsakcZHjoi.tlzoqtAys\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 7028,\n \"limit\": 8716,\n \"offset\": 1622,\n \"total\": 5079\n },\n \"results\": {\n \"total\": 5514,\n \"total_method\": \"string\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "62177976-2693-4fb0-b382-62de8be21584", "name": "Delete Rule Promotion Codes", "request": { "name": "Delete Rule Promotion Codes", "description": { "content": "Deletes one or more promotion codes from a specific rule promotion.\n\n- Supports **bulk deletion**, allowing multiple codes to be removed in a single request.\n- Removes promotion codes permanently, making them unavailable for future use.\n- If a code has already been redeemed, it will be removed from the system but may still reflect in historical transactions.\n\nA successful request returns a `204 No Content` response, indicating the specified promotion codes have been deleted.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e3354226-420d-4b7f-a64e-b3deb3d6c98c", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ddae428c-52ce-4813-8690-f708f14ce472", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_codes\",\n \"codes\": [\n {\n \"code\": \"spring2024\"\n },\n {\n \"code\": \"summer2024\",\n \"consume_unit\": \"per_checkout\"\n },\n {\n \"code\": \"summer2024_limited\",\n \"consume_unit\": \"per_application\",\n \"uses\": 5\n },\n {\n \"code\": \"summer2024_memberOnly\",\n \"consume_unit\": \"per_application\",\n \"uses\": 1,\n \"user\": \"vip_shopper@email.com\"\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 7932,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n },\n {\n \"status\": 2534,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"source\": \"string\",\n \"meta\": {\n \"usage_ids\": [\n \"string\",\n \"string\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b03029fd-b6e7-440b-9d71-fa66a977e19b", "name": "Delete A Single Rule Promotion Code", "request": { "name": "Delete A Single Rule Promotion Code", "description": { "content": "Deletes a single promotion code from a specific rule promotion.\n\n- Permanently removes the specified promotion code, making it unavailable for future use.\n- Can be used to **revoke a specific code** without affecting other codes under the same promotion.\n- If the code has already been redeemed, it will still be removed from the system but may still reflect in historical transactions.\n\nA successful request returns a `204 No Content` response, indicating the specified promotion code has been deleted.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":codeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "codeID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion code.", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d1f93d87-9707-431f-8f75-8ca683c915a6", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":codeID" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion code.", "type": "text/plain" }, "type": "any", "value": "string", "key": "codeID" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rule Promotion Jobs", "description": "", "item": [ { "id": "3b9c5416-f101-4999-9e83-c1d87a30ab43", "name": "Create a Rule Promotion Job", "request": { "name": "Create a Rule Promotion Job", "description": { "content": "Creates an asynchronous job for a specific Rule Promotion. Jobs are used to generate or export promotion codes in bulk.\n\nThe following job types are supported:\n- **`code_generate`**: Generates a batch of unique promotion codes.\n- **`code_export`**: Exports all existing promotion codes as a downloadable CSV file.\n\nJob processing occurs asynchronously. The job request is queued, and its status must be checked separately.\n\n### Job Processing Status\nJobs can have the following statuses:\n- `pending`: Job is in the queue, waiting to be processed.\n- `processing`: Job is actively being processed.\n- `completed`: Job completed successfully.\n- `failed`: Job encountered an error and did not complete.\n- `cancelling`: Cancellation in progress (for long-running jobs).\n- `cancelled`: Job was successfully cancelled.\n\nPlease refer to the **OpenAPI examples** section on this page for sample job creation requests.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_job\",\n \"job_type\": \"code_generate\",\n \"name\": \"Demo bulk code generate\",\n \"parameters\": {\n \"number_of_codes\": 100,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"summer-\",\n \"code_length\": 8\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ad0d3c39-6588-459a-8cd3-d646408c1708", "name": "Promotion job created", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_job\",\n \"job_type\": \"code_generate\",\n \"name\": \"Demo bulk code generate\",\n \"parameters\": {\n \"number_of_codes\": 100,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"summer-\",\n \"code_length\": 8\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"job_type\": \"code_export\",\n \"name\": \"string\",\n \"parameters\": {\n \"number_of_codes\": 737,\n \"max_uses_per_code\": 1384,\n \"consume_unit\": \"per_application\",\n \"code_prefix\": \"string\",\n \"code_length\": 8\n },\n \"id\": \"string\",\n \"type\": \"string\",\n \"rule_promotion_id\": \"string\",\n \"status\": \"cancelled\",\n \"error\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"1966-01-09T02:27:02.953Z\",\n \"updated_at\": \"1953-09-06T14:21:09.350Z\"\n }\n },\n \"result\": {\n \"generated\": 1000,\n \"deleted\": 50\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1267df71-a2af-46b2-9175-4cab87de20be", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"promotion_job\",\n \"job_type\": \"code_generate\",\n \"name\": \"Demo bulk code generate\",\n \"parameters\": {\n \"number_of_codes\": 100,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"summer-\",\n \"code_length\": 8\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"400\",\n \"title\": \"Too many jobs\",\n \"detail\": \"Only 1 pending or processing job is allowed per promotion.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7a5ff9ed-4800-4269-961e-0067b0e3ef6b", "name": "Get Rule Promotion Jobs", "request": { "name": "Get Rule Promotion Jobs", "description": { "content": "Retrieves a list of jobs associated with a specific rule promotion. Each job represents an asynchronous operation such as promotion code generation or export.\n\nThe response includes details such as:\n- **Job type** (`code_generate` or `code_export`)\n- **Job status** (`pending`, `processing`, `completed`, `failed`, `cancelling`, or `cancelled`)\n- **Parameters used** (such as number of codes generated)\n- **Results** (such as number of codes successfully generated or deleted)\n\n### Filtering\nYou can filter jobs by:\n- **Job Type** (`eq(job_type, code_export)`)\n- **Status** (`eq(status, complete)`)\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "type": "any", "value": "string", "key": "uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e210572e-d576-40dc-91c1-65f367abe304", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Specifies filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"job_type\": \"code_generate\",\n \"name\": \"string\",\n \"parameters\": {\n \"number_of_codes\": 336,\n \"max_uses_per_code\": 1711,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"string\",\n \"code_length\": 8\n },\n \"id\": \"string\",\n \"type\": \"string\",\n \"rule_promotion_id\": \"string\",\n \"status\": \"pending\",\n \"error\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"1957-03-25T00:54:30.185Z\",\n \"updated_at\": \"1985-05-08T12:56:54.733Z\"\n }\n },\n \"result\": {\n \"generated\": 1000,\n \"deleted\": 50\n }\n },\n {\n \"job_type\": \"code_generate\",\n \"name\": \"string\",\n \"parameters\": {\n \"number_of_codes\": 132,\n \"max_uses_per_code\": 1257,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"string\",\n \"code_length\": 8\n },\n \"id\": \"string\",\n \"type\": \"string\",\n \"rule_promotion_id\": \"string\",\n \"status\": \"processing\",\n \"error\": \"string\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"1960-09-18T17:11:58.451Z\",\n \"updated_at\": \"2004-03-19T12:05:48.476Z\"\n }\n },\n \"result\": {\n \"generated\": 1000,\n \"deleted\": 50\n }\n }\n ],\n \"links\": {\n \"current\": \"https://IziNQHZButlyUeUKCCdew.ztcq3jyu5qUxhTbpFFb4zXFok,50rSvPP\",\n \"first\": \"https://VupptkSMtX.ckSQDwpSkgTox3SG-h49ooyBjWk95idhsmhAqr8,TfpeRNBH,t+1Gjv88tsTEDm+rUgFSYUIaELiB3il\",\n \"last\": \"http://rTtJWdwE.ojRe8SQtBDw4ol3TnXeAsZI.rJSqwJIITZPjrS9rtaQSD7wJ\",\n \"next\": \"https://fOIYkZeHZbw.sljrQENu.+emLiTF\",\n \"prev\": \"https://eKRI.rdtoBagtzrjo9vGyO8PHo-mwopRwqc7MVFkw1MsKn6,y5i4G7,Nrsb2ZEgkzpP\"\n },\n \"meta\": {\n \"page\": {\n \"current\": 8218,\n \"limit\": 2114,\n \"offset\": 8465,\n \"total\": 9812\n },\n \"results\": {\n \"total\": 2360,\n \"total_method\": \"string\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f550b909-f7e7-4eac-a3ae-df0886264857", "name": "Get Rule Promotion Code Exported File", "request": { "name": "Get Rule Promotion Code Exported File", "description": { "content": "Retrieves the exported promotion codes for a rule promotion job in a CSV format.\n\n- The file contains the generated codes along with relevant metadata.\n- This endpoint is applicable only for jobs of type `code_export`.\n- The job must be in a `completed` state before the file can be retrieved.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs", ":job-uuid", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "job-uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the job associated with the file.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0813aa7a-d049-4626-9459-d9658dd24e16", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs", ":job-uuid", "file" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the job associated with the file.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job-uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"href\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "af532cce-7073-4a7b-81e2-b21426488143", "name": "Cancel a Rule Promotion Job", "request": { "name": "Cancel a Rule Promotion Job", "description": { "content": "Cancels an asynchronous job for a rule promotion if its status is `pending` or `processing`.\n\n- Only jobs that have not yet completed can be canceled.\n- Once canceled, no further processing occurs, and partially completed results may be deleted.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs", ":job-uuid", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "string", "key": "uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "job-uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the job to be canceled.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1c98987c-939c-4810-9aab-f6598360ab1a", "name": "Successfully Canceled the Rule Promotion Job", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs", ":job-uuid", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the job to be canceled.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job-uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"promotion_job\",\n \"id\": \"9bc1391c-1b65-419e-940e-66ed86c07001\",\n \"rule_promotion_id\": \"8c150382-b258-4c88-a2d4-b9ea0be74a07\",\n \"job_type\": \"code_generate\",\n \"name\": \"Demo bulk code generate\",\n \"parameters\": {\n \"number_of_codes\": 100,\n \"max_uses_per_code\": 1,\n \"consume_unit\": \"per_checkout\",\n \"code_prefix\": \"summer-\",\n \"code_length\": 8\n },\n \"status\": \"cancelling\",\n \"meta\": {\n \"timestamps\": {\n \"created_at\": \"2024-12-03T23:31:40.962680423Z\",\n \"updated_at\": \"2024-12-03T23:31:40.962680423Z\"\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c57b8cf-b3da-45c4-945e-ef7b3c9c1ec2", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":uuid", "jobs", ":job-uuid", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the job to be canceled.", "type": "text/plain" }, "type": "any", "value": "string", "key": "job-uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": \"422\",\n \"title\": \"Unprocessable Entity\",\n \"detail\": \"Only pending or processing jobs can be cancelled.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rule Promotion Usages", "description": "", "item": [ { "id": "577ecb81-66a5-4cd6-8494-afa0c3a91929", "name": "Anonymize Rule Promotion Usages", "request": { "name": "Anonymize Rule Promotion Usages", "description": { "content": "Anonymizes user-related data in Rule Promotion usage records. \nThis operation is typically used for GDPR compliance or privacy-related requests.\n\n- This process replaces identifiable user data with anonymized placeholders.\n- Affects all recorded promotion usages where customer data is stored.\n- Does not impact historical transaction records or applied discounts.\n\nA successful request returns a `200 OK` response with the anonymized usage records.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", "usages", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"usage_ids\": [\n \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"d4e5f6g7-h8i9-0j1k-2l3m-4n5o6p7q8r9s\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "63ce9e6b-2715-49fb-8a70-c71ba201442d", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", "usages", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"usage_ids\": [\n \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"d4e5f6g7-h8i9-0j1k-2l3m-4n5o6p7q8r9s\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"order_id\": \"8edd5ca8-39b7-468d-aea9-a470690ca98d\",\n \"code_id\": \"00fc633b-9932-4e18-b122-fd5c3173caa3\",\n \"code\": \"node1off\",\n \"times_used\": 1,\n \"used_on\": \"2023-06-19T18:05:20.846Z\",\n \"customer_id\": \"9ef25142-d67a-41d3-99b2-4d30aeef6c9d\",\n \"customer_email\": \"**\",\n \"meta\": {\n \"timestamps\": {\n \"updated_at\": \"2023-06-19T18:05:39.141Z\"\n }\n },\n \"updated_by\": \"Key-2439657140697170361\",\n \"anonymized\": true\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e11ce7ff-a70e-45e5-ac07-0e9b5815f881", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", "usages", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"usage_ids\": [\n \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"d4e5f6g7-h8i9-0j1k-2l3m-4n5o6p7q8r9s\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 400,\n \"title\": \"Invalid Request\",\n \"detail\": \"The request payload is malformed or missing required fields.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9d314f5-c4df-42c7-bd88-fc56bd2c2a75", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", "usages", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"usage_ids\": [\n \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"d4e5f6g7-h8i9-0j1k-2l3m-4n5o6p7q8r9s\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"detail\": \"Authentication credentials were missing or incorrect.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "805d7703-a091-42cb-9deb-cabcc699a2e5", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", "usages", "anonymize" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"usage_ids\": [\n \"ca4385ec-7fb2-4a95-8690-f752c508d68a\",\n \"d4e5f6g7-h8i9-0j1k-2l3m-4n5o6p7q8r9s\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Usages Not Found\",\n \"detail\": \"Some usage IDs could not be found.\",\n \"meta\": {\n \"usage_ids\": [\n \"invalid-usage-id-1\",\n \"invalid-usage-id-2\"\n ]\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fcb5df17-0165-44d7-a69a-b8566e0ac32a", "name": "Get Rule Promotion Usages", "request": { "name": "Get Rule Promotion Usages", "description": { "content": "Retrieves a list of usage records for a specific Rule Promotion.\n\n- Provides details about when and how a promotion was used.\n- Can be filtered and paginated to refine results.\n- Useful for analyzing promotion effectiveness and customer engagement.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the usage records. Supported attributes:\n- `id`: Filter by usage ID.\n- `code`: Filter by promotion code.\n- `used_on`: Filter by usage date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "eq(code,cart1off)" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3940bfb1-b6cc-4103-8fca-694624257017", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the usage records. Supported attributes:\n- `id`: Filter by usage ID.\n- `code`: Filter by promotion code.\n- `used_on`: Filter by usage date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "eq(code,cart1off)" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"a9b73e4d-637f-4f1c-9b3e-2de1f8a70351\",\n \"order_id\": \"e3d7b9fa-4a90-4e98-bac2-d7a4b4f2f63f\",\n \"code_id\": \"8a2c3f47-9d3b-4562-8392-4e5e6cda3d2b\",\n \"code\": \"cart10off\",\n \"times_used\": 1,\n \"used_on\": \"2024-02-20T15:42:00.000Z\",\n \"customer_id\": \"4f3e8c5d-37e4-43fb-9276-d1b76f0c3a2a\",\n \"customer_email\": \"shopper@example.com\",\n \"meta\": {\n \"timestamps\": {\n \"updated_at\": \"2024-02-20T15:45:00.000Z\"\n }\n },\n \"updated_by\": \"Admin-User-123\"\n }\n ],\n \"links\": {\n \"first\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/usages?page%5Boffset%5D=0&page%5Blimit%5D=10\",\n \"last\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/usages?page%5Boffset%5D=90&page%5Blimit%5D=10\",\n \"prev\": null,\n \"next\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/usages?page%5Boffset%5D=10&page%5Blimit%5D=10\"\n },\n \"meta\": {\n \"pagination\": {\n \"total\": 100,\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7c3dc57-8ff0-43ec-9838-c21aff4da06b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the usage records. Supported attributes:\n- `id`: Filter by usage ID.\n- `code`: Filter by promotion code.\n- `used_on`: Filter by usage date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "eq(code,cart1off)" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"detail\": \"Authentication is required to access this resource.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "906571c5-d546-4393-b891-f6a007a8f8f0", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the usage records. Supported attributes:\n- `id`: Filter by usage ID.\n- `code`: Filter by promotion code.\n- `used_on`: Filter by usage date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "eq(code,cart1off)" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Promotion Not Found\",\n \"detail\": \"No usages found for the specified promotion ID.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b38d9a6a-26f8-494c-b0f7-e2e8030dfca0", "name": "Get Rule Promotion Code Usages", "request": { "name": "Get Rule Promotion Code Usages", "description": { "content": "Retrieves a list of usage records for a specific Rule Promotion code.\n\n- Provides insights into how many times a specific code was used.\n- Can be filtered and paginated to refine results.\n- Useful for tracking the performance of individual promotion codes.\n", "type": "text/plain" }, "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":code", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the results. Supported attributes:\n- `id`: Filter by usage ID.\n- `used_on`: Filter by date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "gt(used_on,2024-02-01T00:00:00Z)" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "string", "key": "promotionID", "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" } }, { "type": "any", "value": "string", "key": "code", "disabled": false, "description": { "content": "(Required) The specific promotion code for which to retrieve usage records.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5288c02b-d629-4424-8b0d-c2f28e70ec07", "name": "Successful response", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":code", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the results. Supported attributes:\n- `id`: Filter by usage ID.\n- `used_on`: Filter by date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "gt(used_on,2024-02-01T00:00:00Z)" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The specific promotion code for which to retrieve usage records.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"c2f45a8d-6ebf-4b6a-8b1c-d2e7c9e0f45f\",\n \"order_id\": \"1a3b5c7d-9e2f-4a5b-8c1d-6e3f9b0d4c5f\",\n \"code_id\": \"5d7e9f2b-3c4a-6b8d-1e9f-0a2b3c4d5e6f\",\n \"code\": \"holiday50\",\n \"times_used\": 2,\n \"used_on\": \"2024-02-18T10:30:00.000Z\",\n \"customer_id\": \"7e6c5d4b-3a2f-1e9d-8b0c-9f4e7d6c3b5a\",\n \"customer_email\": \"vipuser@example.com\",\n \"meta\": {\n \"timestamps\": {\n \"updated_at\": \"2024-02-18T10:35:00.000Z\"\n }\n },\n \"updated_by\": \"Admin-User-456\"\n }\n ],\n \"links\": {\n \"first\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/codes/holiday50/usages?page%5Boffset%5D=0&page%5Blimit%5D=10\",\n \"last\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/codes/holiday50/usages?page%5Boffset%5D=10&page%5Blimit%5D=10\",\n \"prev\": null,\n \"next\": \"https://useast.api.elasticpath.com/v2/rule-promotions/123/codes/holiday50/usages?page%5Boffset%5D=10&page%5Blimit%5D=10\"\n },\n \"meta\": {\n \"pagination\": {\n \"total\": 20,\n \"limit\": 10,\n \"offset\": 0,\n \"current\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96d5e2bf-eb2c-4e57-a926-a851570da93b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":code", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the results. Supported attributes:\n- `id`: Filter by usage ID.\n- `used_on`: Filter by date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "gt(used_on,2024-02-01T00:00:00Z)" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The specific promotion code for which to retrieve usage records.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"detail\": \"Authentication is required to access this resource.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d57d5e8-253b-4260-bf50-67177cf4acae", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "rule-promotions", ":promotionID", "codes", ":code", "usages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Filter attributes to refine the results. Supported attributes:\n- `id`: Filter by usage ID.\n- `used_on`: Filter by date with operators `gt`, `ge`, `le`, `lt`.\n", "type": "text/plain" }, "key": "filter", "value": "gt(used_on,2024-02-01T00:00:00Z)" }, { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "10" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the rule promotion.", "type": "text/plain" }, "type": "any", "value": "string", "key": "promotionID" }, { "disabled": false, "description": { "content": "(Required) The specific promotion code for which to retrieve usage records.", "type": "text/plain" }, "type": "any", "value": "string", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"status\": 404,\n \"title\": \"Promotion Code Not Found\",\n \"detail\": \"No usages found for the specified promotion code.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Settings", "description": "The Settings API allow you to configure global settings for your project.", "item": [ { "id": "183c66d9-e6e5-46fd-bd9d-9bd66cdbb5f0", "name": "Get Project Settings", "request": { "name": "Get Project Settings", "description": { "content": "You can get all of the project settings via one API call using a `client_credential` token. The response is in object format as shown in the following example.\n\n:::note\n\nThe default `calculation_method` is `line`.\n\n:::", "type": "text/plain" }, "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cdd1ae38-b89f-4687-bb54-a2fd766b6df9", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25,\n \"id\": \"61daaa08-9z05-4497-b9ca-626cd0f9932b\",\n \"include_organization_resources\": false,\n \"cart_item_limit\": 100,\n \"custom_discount_limit\": 5,\n \"currency_limit\": 10,\n \"field_limit\": 100,\n \"integration_limit\": 100,\n \"event_limit\": 5,\n \"filter_limit\": 10,\n \"tax_item_limit\": 5,\n \"promotions_limit\": 1000,\n \"promotion_codes_limit\": 1000,\n \"page_offset_limit\": 10000\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bee73720-b481-4b40-b4cd-1aad9b5259a0", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdfc664c-94f4-4862-9a48-22fd12f30b67", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9760b4d0-c549-4a72-a297-4e6df5503980", "name": "Update Project Settings", "request": { "name": "Update Project Settings", "description": { "content": "You can use the Settings endpoint to update your project settings at any time. These global settings take immediate effect.", "type": "text/plain" }, "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "54b938bf-901e-45a4-a3b2-b21a2237d79d", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25,\n \"id\": \"61daaa08-9z05-4497-b9ca-626cd0f9932b\",\n \"include_organization_resources\": false,\n \"cart_item_limit\": 100,\n \"custom_discount_limit\": 5,\n \"currency_limit\": 10,\n \"field_limit\": 100,\n \"integration_limit\": 100,\n \"event_limit\": 5,\n \"filter_limit\": 10,\n \"tax_item_limit\": 5,\n \"promotions_limit\": 1000,\n \"promotion_codes_limit\": 1000,\n \"page_offset_limit\": 10000\n },\n \"meta\": {\n \"owner\": \"store\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f21c146-7113-4a08-9817-1f2f6ee5fda4", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"enum\",\n \"source\": \"data.type\",\n \"detail\": \"data.type must be one of the following: \\\"settings\\\"\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cee551c2-00a3-4299-b703-40b74afa0395", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"type\": \"settings\",\n \"page_length\": 25,\n \"list_child_products\": false,\n \"additional_languages\": [\n \"es\",\n \"fr\",\n \"de\"\n ],\n \"calculation_method\": \"line\",\n \"address_mandatory_fields\": [\n \"first_name\",\n \"last_name\",\n \"line_1\",\n \"city\",\n \"region\",\n \"postcode\",\n \"country\",\n \"instructions\"\n ],\n \"shopper_address_limit\": 25\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1a3c4ffd-d52c-4dbc-839d-7a5bb8740748", "name": "Delete Project Settings", "request": { "name": "Delete Project Settings", "description": { "content": "Deletes a store setting. Organization settings cannot be deleted.", "type": "text/plain" }, "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "b2b0f0b1-5ba1-4085-8c42-11cf56a16a8e", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "32e387dc-0744-4184-a872-49267f9c058d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8508a12-171b-4c8f-9083-fc49c1a37601", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}\n", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Authentication Realms", "description": "An authentication realm is a container that consists of the following:\n\n - Users - Represented by [User Authentication Info](/docs/api/single-sign-on/user-authentication-infos) objects\n - Authentication profiles - Ways for the users to authenticate, such as one or more [OpenID Connect Profiles](/docs/api/single-sign-on/oidc-profiles) or [Password Profiles](/docs/api/single-sign-on/password-profiles)\n - Mappings between users and authentication profiles - [User Authentication OpenID Connect Profile Info](/docs/api/single-sign-on/user-authentication-oidc-profile-infos) or [User Authentication Password Profile Infos](/docs/api/single-sign-on/user-authentication-password-profile-infos)\n\nHere's a domain diagram showing these relationships\n![authentication realm](/assets/authentication-realm-domain.png)\n\nComposable Commerce comes with three per-store pre-set realms:\n - Buyer Organization. For customers: users who buy products from your store.\n - Merchant Organization. For administrators: users who log in to Commerce Manager to modify the store’s settings or catalog.\n - Account Management Realm. For account members: users who buy products from your store on behalf of accounts. Password profiles are only available for account management realm.\n", "item": [ { "id": "b5daffde-dc25-4aec-836e-b9c3c4789fea", "name": "Get all Authentication Realms", "request": { "name": "Get all Authentication Realms", "description": { "content": "Retrieve a list of all authentication realms configured for your store.\nAuthentication Realms allow you to configure authentication options and manage single sign-on settings. Each realm contains users, authentication profiles, and mappings between users and authentication profiles.\n", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "edac0711-97ac-400c-b2df-d7080e9c04f7", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"45928070-44a6-448b-8246-a85aa35320af\",\n \"type\": \"authentication-realm\",\n \"name\": \"Buyer Organization\",\n \"duplicate_email_policy\": \"allowed\",\n \"redirect_uris\": [\n \"https://example-shop.com/oidc/callback\"\n ],\n \"relationships\": {\n \"origin\": {\n \"data\": {\n \"id\": \"0\",\n \"type\": \"customer-authentication-settings\"\n }\n }\n }\n },\n {\n \"id\": \"bbd4a3f8-6a93-44a2-8f4f-2a1e3f8b3b9c\",\n \"type\": \"authentication-realm\",\n \"name\": \"Merchant Organization\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://cm.example.com/oidc/callback\"\n ],\n \"relationships\": {\n \"origin\": {\n \"data\": {\n \"id\": \"1\",\n \"type\": \"merchant-realm-mappings\"\n }\n }\n }\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbd33017-b514-4281-abb9-d2303751fae0", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad5bf799-257e-4415-b69d-bf6d6a4696db", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unauthorized\",\n \"status\": \"401\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c47f73f6-53a7-4410-8028-43a90fb92583", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b15ee2c8-73bc-423b-9782-09b1218625f6", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa41534f-d494-4053-9f0d-47103c9cc23e", "name": "Get an Authentication Realm", "request": { "name": "Get an Authentication Realm", "description": { "content": "Retrieve a specific authentication realm by its ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7f8b4ba0-ace6-4b61-afe0-cbe258b52a26", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"45928070-44a6-448b-8246-a85aa35320af\",\n \"type\": \"authentication-realm\",\n \"name\": \"Buyer Organization\",\n \"duplicate_email_policy\": \"allowed\",\n \"redirect_uris\": [\n \"https://example-shop.com/oidc/callback\"\n ],\n \"relationships\": {\n \"origin\": {\n \"data\": {\n \"id\": \"0\",\n \"type\": \"customer-authentication-settings\"\n }\n }\n }\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32a26cb9-43a5-452f-8f15-54f5e4e26d38", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53acd24f-cc14-4c3f-ac4a-43ea04cc4723", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0eef30a5-27c2-4245-9826-968a2c8b1a29", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a03b06d-af98-40bf-b4b1-904dcfb94b39", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to retrieve.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d0599fa-3af8-4eb4-bdfd-8164140d6ca1", "name": "Update an Authentication Realm", "request": { "name": "Update an Authentication Realm", "description": { "content": "Update a specific authentication realm by its ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "354b3bc4-131c-4699-9eaf-844bbdd7e45e", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-auth-realm\",\n \"duplicate_email_policy\": \"allowed\",\n \"redirect_uris\": [\n \"https://example.com/callback\"\n ],\n \"relationships\": {\n \"origin\": {\n \"data\": {\n \"id\": \"0\",\n \"type\": \"merchant-realm-mappings\"\n }\n }\n },\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23\"\n }\n },\n \"links\": {\n \"self\": \"https://NHuAwVxI.ghzhXt9.BPIMoDOFPU2sNudv1g+i8Hd\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99cdd3ce-fdb4-47af-be05-821f3e201c54", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b57a0690-7859-4809-a504-a5b248bfeea8", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d04c1543-3da1-4d90-93e4-433132431db4", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10d29cb0-3e45-4acc-a21c-e3b6c7622b84", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm to update.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"authentication-realm\",\n \"name\": \"updated-auth-realm\",\n \"duplicate_email_policy\": \"disallowed\",\n \"redirect_uris\": [\n \"https://updated-example.com/callback\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "OIDC Profiles", "description": "An OpenID Connect Profile resource represents a specific configuration of an OpenID Connect Provider.\n\nAn authentication realm can have multiple OpenID Connect Profiles. This allows shoppers to authenticate using multiple OpenID providers. In the example shown below, Jane can login using both Apple and Google, whereas Joan can only login using Google.\n\n![oidc profiles](/assets/oidc-profiles.png)\n", "item": [ { "id": "9918dfb6-d0a2-4478-88b0-c003cc54cc24", "name": "Create an OIDC Profile", "request": { "name": "Create an OIDC Profile", "description": { "content": "Create an OpenID Connect profile for the specified authentication realm.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ef159aa4-02ab-4270-ad31-c16367e7a3cf", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2025-09-08T20:58:56.355Z\",\n \"updated_at\": \"2025-09-08T20:58:56.355Z\",\n \"issuer\": \"https://test.issuer.com\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/oidc-profiles/abc123\",\n \"authorization-endpoint\": \"https://aFJGHRv.gmdLr-\",\n \"callback-endpoint\": \"https://eVYnpySnRnXrDurwVjjCMJDQ.wovnxOPyxFRDGHXnOB3GeQEetujgl1,NVhlq4lBmMqFaf.tPZuE\",\n \"client-discovery-url\": \"https://E.mftkzBKH85tWEqG3LDd47rnIayJs2CAZ4Cw1Myli3Y7\"\n }\n },\n \"links\": {\n \"self\": \"https://qolWwK.chuw97zamI0wHPzUhqYU-xI86n.Hf+hmk0a4P3ZhFYqV-DITygh,MbIWSoNz\",\n \"authorization-endpoint\": \"http://qyrUcF.zgwzVpCXTRvXyslxoe9g-A2PFXEIYzPVG,m95arOetZzS1YPJdktQgKGsKepJ4r\",\n \"callback-endpoint\": \"https://KphIZJpzmdaSNeqwjAv.neskN8JqlnyzEBHQRcErhAKsVOt1Rrk5\",\n \"client-discovery-url\": \"https://GRDffF.enhuZue9EF1nHRuuPHzjg4g\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8fc6e34d-311f-4211-83b9-fb7041c2e103", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f65a268e-250c-4f25-8116-fd45d7fea600", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecd513fe-b7ff-43b9-9ed7-0db5e302b1eb", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0846b97a-ade5-4261-b2dd-a3e0a0860398", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "77a94ff9-9db5-4da0-989b-7f6dc06cc222", "name": "Get OIDC Profiles", "request": { "name": "Get OIDC Profiles", "description": { "content": "Retrieve OIDC profiles for the specified authentication realm.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1d72503f-ed6b-472d-9ec8-3c7ffe6d0004", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"c8849022-c9c6-4888-9ca8-2bb78f445fb0\",\n \"type\": \"oidc-profile\",\n \"name\": \"Google\",\n \"issuer\": \"https://accounts.google.com\",\n \"client_id\": \"google-client-id\"\n },\n {\n \"id\": \"21be087e-faa6-41fc-9b51-6763a363ec2d\",\n \"type\": \"oidc-profile\",\n \"name\": \"Apple\",\n \"issuer\": \"https://appleid.apple.com\",\n \"client_id\": \"apple-client-id\"\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/oidc-profiles?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/oidc-profiles?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afb67c60-76bd-4005-af3a-c01b0d12c9bc", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8204d0d8-ed6a-46ef-8e85-e951f13d7fec", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "248371cd-1249-4376-bd10-ba86b52a36d2", "name": "Get OIDC Profile", "request": { "name": "Get OIDC Profile", "description": { "content": "Retrieve a specific OIDC profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2a63dc1a-396a-4058-9517-520b47b46f6b", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"c8849022-c9c6-4888-9ca8-2bb78f445fb0\",\n \"type\": \"oidc-profile\",\n \"name\": \"Google\",\n \"issuer\": \"https://accounts.google.com\",\n \"client_id\": \"google-client-id\"\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/oidc-profiles/c8849022-c9c6-4888-9ca8-2bb78f445fb0\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52b0c828-7b64-4ecf-a182-d50fffd6e5e8", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57ed0d82-1981-4e95-aed2-a7c3df47f6bf", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18273843-9823-4701-b7df-52c2d1fad46f", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb2c20f5-9795-4aac-8bfc-1f1f7db68b4f", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "66d8dd5f-96a3-4119-a51c-be5a5b722ece", "name": "Update OIDC Profile", "request": { "name": "Update OIDC Profile", "description": { "content": "Update a specific OIDC profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "99953c03-41e8-4971-b5d0-ca922a0241f9", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2025-09-08T20:58:56.355Z\",\n \"updated_at\": \"2025-09-08T20:58:56.355Z\",\n \"issuer\": \"https://test.issuer.com\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/oidc-profiles/abc123\",\n \"authorization-endpoint\": \"https://aFJGHRv.gmdLr-\",\n \"callback-endpoint\": \"https://eVYnpySnRnXrDurwVjjCMJDQ.wovnxOPyxFRDGHXnOB3GeQEetujgl1,NVhlq4lBmMqFaf.tPZuE\",\n \"client-discovery-url\": \"https://E.mftkzBKH85tWEqG3LDd47rnIayJs2CAZ4Cw1Myli3Y7\"\n }\n },\n \"links\": {\n \"self\": \"https://qolWwK.chuw97zamI0wHPzUhqYU-xI86n.Hf+hmk0a4P3ZhFYqV-DITygh,MbIWSoNz\",\n \"authorization-endpoint\": \"http://qyrUcF.zgwzVpCXTRvXyslxoe9g-A2PFXEIYzPVG,m95arOetZzS1YPJdktQgKGsKepJ4r\",\n \"callback-endpoint\": \"https://KphIZJpzmdaSNeqwjAv.neskN8JqlnyzEBHQRcErhAKsVOt1Rrk5\",\n \"client-discovery-url\": \"https://GRDffF.enhuZue9EF1nHRuuPHzjg4g\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75fea306-735e-4b99-8a3d-33db2f585473", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3f8e8fc-33c4-45db-9753-1d203adf3b3d", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d8b6bc1-c9dd-4a4b-b73a-35bae0d442e2", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5307daa6-187b-4908-863c-6829df8fe01b", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-oidc-profile\",\n \"discovery_url\": \"https://example.com/.well-known/openid_configuration\",\n \"client_id\": \"my-client-id\",\n \"client_secret\": \"my-client-secret\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "172f545b-57ee-43b9-a839-def8e27e936f", "name": "Delete OIDC Profile", "request": { "name": "Delete OIDC Profile", "description": { "content": "Delete a specific OIDC profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "baef9832-e66f-42e7-9938-b09a40d3b457", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "418b3b25-1412-4789-bb35-9fac0f128471", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e45d8484-7014-4b60-b0bb-46a399b1a24f", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce1d2a7c-745d-417c-83fa-eb1c0765c3a2", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b6c9554-e924-4769-9566-1b990a91de7d", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "oidc-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Password Profiles", "description": "A `password_profile` resource represents a specific configuration that allows users to authenticate through username and password.\n\nPassword Profiles support One-Time Password Tokens, which can be used to use passwordless login or password reset.\n\nAn authentication realm can have multiple Password Profiles. You can use this flexibility in many ways. For instance, if you want to migrate an existing pool of users from another system with their own usernames and passwords, they can use one profile, while the rest of the users use another.\n\nAnother use case is enabling shopper impersonation, where shoppers can authenticate using their own username and password in one profile. Meanwhile, admins can have a different username and password for the same user in a separate profile, shown as the \"Impersonation Profile\". This process can be automated using a Backend-For-Frontend (BFE) or One-Time Password Tokens. In the example shown below, both John and Joan can log in with their credentials, and an admin can also log in as Joan using the \"Impersonation Profile\".\n\n![password profiles](/assets/password-profiles.png)\n", "item": [ { "id": "a87cfdee-13c6-4c7e-b572-bd1426b1318d", "name": "Get Password Profiles", "request": { "name": "Get Password Profiles", "description": { "content": "Retrieve password profiles for the specified authentication realm.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "182ddbde-5d65-4724-91ea-89ef71cea6fd", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"a2f6d4c0-1d2b-4b3a-9e5a-2f4b1c7d8e9f\",\n \"type\": \"password_profile\",\n \"name\": \"Default Passwords\",\n \"require_uppercase\": true,\n \"require_numbers\": true,\n \"min_length\": 10\n },\n {\n \"id\": \"b3e7f5a1-2c3d-4e4b-8f6a-3e5c2d8f9a0b\",\n \"type\": \"password_profile\",\n \"name\": \"Impersonation Profile\",\n \"require_uppercase\": false,\n \"require_numbers\": false,\n \"min_length\": 8\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/password-profiles?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/password-profiles?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "636f70f3-2e5a-44af-bd99-540f910a5f1e", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02bbb448-64df-41e6-b934-0e4b270c04dd", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "866fa4a0-b147-4eae-a7e8-b6b1f01ab390", "name": "Create Password Profile", "request": { "name": "Create Password Profile", "description": { "content": "Create a password profile for the specified authentication realm.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "e231450d-eff1-4897-8959-c8d63d4a6c2c", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true,\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/password-profiles/abc123\"\n }\n },\n \"links\": {\n \"self\": \"https://FsKWoYwMzRCGWdXmJlLJtfsDIWlcw.lmnN2wP+zersvdMgmnnMiR.M1u9e75joPvYseZpH1gKRYBH6IJMfO+hUGzkwN\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e41b5fc0-9732-4567-9a06-08801803d343", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe755a4d-b49b-4df7-a1c7-883d3dcbb3ae", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bee21d9-0700-4001-9f92-aee652d7cb23", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "988ba2cd-bbea-40e8-9daf-293e9bf00155", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "04069739-cf09-44a0-b555-f6a78cd419bf", "name": "Get Password Profile", "request": { "name": "Get Password Profile", "description": { "content": "Retrieve a specific password profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "79d2ee31-07de-49ee-ac63-94f8908e7000", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a2f6d4c0-1d2b-4b3a-9e5a-2f4b1c7d8e9f\",\n \"type\": \"password_profile\",\n \"name\": \"Default Passwords\"\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/password-profiles/a2f6d4c0-1d2b-4b3a-9e5a-2f4b1c7d8e9f\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "902ccfcd-531a-4ec6-8102-133c28abf083", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76612de9-8bb6-4651-8ad1-776fde6ea428", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b258c9e1-62fb-4e1a-aace-4cd31c33e518", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "113fe433-213b-4cba-a653-dd44f35aaf06", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e4354936-8b9c-450f-8bf6-daee803e71ff", "name": "Update Password Profile", "request": { "name": "Update Password Profile", "description": { "content": "Update a specific password profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "3e8fe55a-3556-42a6-86c5-4aaea62d7307", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true,\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/password-profiles/abc123\"\n }\n },\n \"links\": {\n \"self\": \"https://FsKWoYwMzRCGWdXmJlLJtfsDIWlcw.lmnN2wP+zersvdMgmnnMiR.M1u9e75joPvYseZpH1gKRYBH6IJMfO+hUGzkwN\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f0637da-0c58-4b32-9faa-e073cfaa720a", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e62c80b-3066-4723-9135-58d0a536994a", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7d23bac-4a0d-4fff-98b5-25b3a8c5a5eb", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08546d6a-ba4a-42d2-8d57-894091839df5", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"my-password-profile\",\n \"username_format\": \"email\",\n \"enable_one_time_password_token\": true\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b450244f-7642-479f-ab1d-46b2d4084707", "name": "Delete Password Profile", "request": { "name": "Delete Password Profile", "description": { "content": "Delete a specific password profile by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "0d4467db-3d6e-4888-9689-53ede5d55bd6", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "43600d12-285e-46be-967b-81cbb261e39c", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "731a9bfd-374e-4ab2-9844-ebd3f230dcdf", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3287edb4-fede-4e75-9a9c-b500199c9fef", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34f6890a-c4b2-4f85-abf4-05239f8135ef", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "da5da1ce-bd75-471d-b522-db34143dbef1", "name": "Create One-Time Password Token Request", "request": { "name": "Create One-Time Password Token Request", "description": { "content": "Create a one-time password token request for the specified password profile.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId", "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7c7677e5-747c-4020-b017-7263a288cfd3", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\",\n \"id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"token\": \"123456\",\n \"expires_at\": \"2023-12-01T10:30:00Z\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89d956c2-c160-44ba-ada6-f82acc4bbd1e", "name": "Accepted", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "889920a9-b83b-4510-95d4-ec0bd730a5f7", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68635381-bd8d-4dde-8f0c-cb2dda55bb34", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "038e1146-b06d-41db-88f4-813d9cf1d5fa", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8505fb3c-c40c-4ba3-aca5-ccdccc3abe9c", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "password-profiles", ":profileId", "one-time-password-token-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "profileId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"\",\n \"purpose\": \"passwordless_authentication\",\n \"username\": \"user@example.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "User Authentication Infos", "description": "\nA `user-authentication-info` represents a user. This object contains information, such as the name and email address, and has sub-resources for each mechanism that the user can use to log in./single-sign-on/authentication-realm-api/authentication-realm-api-overview) and the user is configured to authenticate through that profile, then the `user-authentication-info` object is associated with a [User Authentication OpenID Connect Profile Info](/docs/api/single-sign-on/user-authentication-oidc-profile-infos) subresource.\n\n[Account Members](/docs/api/accounts/get-v-2-account-members-account-member-id) reference User Authentication Infos directly (i.e., for every account member there is an user authentication info with the same id) and the User Authentication Info API is how you manage and configure the authentication options for that user.\n\n[Customers (that login via OIDC)](/docs/customer-management/customer-management-api/get-a-customer) also use the User Authentication Info.\n", "item": [ { "id": "7b234c4c-69ae-4c51-aee7-0cf231020a6e", "name": "Get User Authentication Info List", "request": { "name": "Get User Authentication Info List", "description": { "content": "Retrieve user authentication information for the specified authentication realm.\n### Filtering\n\n\n The following operators and attributes are available for\n [filtering](/guides/Getting-Started/filtering) unassigned account members.\n\n\n | Operator | Description |\n | :------- |:--------------------------------------------------------------------------------------------------- |\n | `eq` | Matches record where the field matches the value (case insensitive) |\n | `ge` | Matches results where the value is greater than or equal to the operand |\n | `gt` | Matches results where the value is greater than the operand |\n | `le` | Matches results where the value is less than or equal to the operand |\n | `lt` | Matches results where the value is less than the operand |\n | `in` | Matches results where the value is in one of a set of values |\n | `ilike` | Checks whether the operand contains the specified string. You can use wildcard characters at the start or end. (Case Insensitive) |\n | `is_null` | Matches records where the field is null. |\n\n\n | Attribute | Type | Operator | Example\n | :-------- | :------- | :------------ | :--------------------------------- |\n | `email` | `string` | `eq`,`ilike` | `eq(email,ronswanson@example.com)` |\n | `name` | `string` | `eq`,`ilike` | `ilike(name,*swan*)` |\n | `created_at` | `string` | `lt`, `le`, `eq`, `gt`, `ge` | `lt(created_at,\"2025-09-10T22:08:47.992Z\")` |\n | `updated_at` | `string` | `lt`, `le`, `eq`, `gt`, `ge` | `gt(updated_at,\"2025-09-10T22:08:47.992Z\")` |\n | `given_name` | `string` | `eq`,`ilike`,`is_null` | `is_null('given_name')` |\n | `middle_name` | `string` | `eq`,`ilike`,`is_null` | `is_null('middle_name')` |\n | `family_name` | `string` | `eq`,`ilike`,`is_null` | `is_null('family_name')` |", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ff1c5053-524f-45ce-9256-274b082aadfc", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c\",\n \"type\": \"user_authentication_info\",\n \"name\": \"Jane Doe\",\n \"email\": \"jane.doe@example.com\"\n },\n {\n \"id\": \"ddb47241-2c69-42cd-b65f-32717cdcf9c1\",\n \"type\": \"user_authentication_info\",\n \"name\": \"John Smith\",\n \"email\": \"john.smith@example.com\"\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8e0bc56-ee03-4d98-8b02-e3eee731babf", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f46e0664-6215-4e14-b741-105785f43a8b", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c91f5d96-fae5-4593-885d-afe7de73cc6f", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "705770ae-28f7-405e-bc8c-ccc1efa2cf44", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" }, { "disabled": false, "description": { "content": "Specifies the filter attributes.", "type": "text/plain" }, "key": "filter", "value": "string" }, { "disabled": false, "description": { "content": "Specifies the order in which account members will be returned. For more information, see [Sorting](/guides/Getting-Started/sorting). (This can only be one of created_at,-created_at,id,-id,updated_at,-updated_at)", "type": "text/plain" }, "key": "sort", "value": "id" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ba059ba3-7546-448f-890e-f27b5976d6b0", "name": "Create User Authentication Info", "request": { "name": "Create User Authentication Info", "description": { "content": "Create user authentication information for the specified authentication realm.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "afcb956e-77e2-4327-be2e-f56507254bd1", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2025-09-08T20:29:42.282Z\",\n \"updated_at\": \"2025-09-08T20:29:42.282Z\",\n \"creation_status\": \"COMPLETE\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123\"\n }\n },\n \"links\": {\n \"self\": \"https://oxMmeNyQirEqUCzKQ.fqWy8n7T9l+zAUQ96OozhwcXkHOAgCEUuiuxFbmAN9SsD1AtstfYYx3KdauG+bxO6\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78d427bd-1e54-4345-93d7-ddb68b2d45b8", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e314b7f1-882e-4b12-ba84-c2303c357d3f", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "103ae29f-5875-49b8-933c-f9c657555ac0", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "baf151bc-c9e3-4b74-a570-579f4062a10f", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6bae5198-47ac-4dba-bd28-fafa2c7b1173", "name": "Get User Authentication Info", "request": { "name": "Get User Authentication Info", "description": { "content": "Retrieve specific user authentication information by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "4ce8c5bd-f7a5-4c70-be53-db74ff4226fa", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c\",\n \"type\": \"user_authentication_info\",\n \"name\": \"Jane Doe\",\n \"email\": \"jane.doe@example.com\"\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2efa32de-7d6b-4369-abba-439f525df0b8", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38d95034-e76f-4196-b389-42e8b2f1b9a3", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "733635df-b7f5-4ff6-a9b4-556c17ca4b65", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bb74a07-96d1-4b66-86f8-b1c31544b865", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "733937d7-3ff1-4619-a465-ef07a9ec42cb", "name": "Update User Authentication Info", "request": { "name": "Update User Authentication Info", "description": { "content": "Update specific user authentication information by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dce20eda-047b-4753-b91f-fcd4fa6d30f6", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2025-09-08T20:29:42.282Z\",\n \"updated_at\": \"2025-09-08T20:29:42.282Z\",\n \"creation_status\": \"COMPLETE\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123\"\n }\n },\n \"links\": {\n \"self\": \"https://oxMmeNyQirEqUCzKQ.fqWy8n7T9l+zAUQ96OozhwcXkHOAgCEUuiuxFbmAN9SsD1AtstfYYx3KdauG+bxO6\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90637f81-3d03-417e-aed5-f13cc3b427d6", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "159f6990-8cfb-4d5d-9947-c9e8fd14e287", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c5326b8-c097-4bd8-a33b-0df9b2403806", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d14e5e4-4d55-42af-99fe-03978b0d984e", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"name\": \"Ron Swanson\",\n \"email\": \"ron@swanson.com\",\n \"given_name\": \"Ron\",\n \"family_name\": \"Swanson\",\n \"middle_name\": \"Ulysses\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f6a4fa65-e5f6-4428-be54-7fca5e04fa8f", "name": "Delete User Authentication Info", "request": { "name": "Delete User Authentication Info", "description": { "content": "Delete specific user authentication information by ID.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "1a68f986-2bf1-43f4-862b-960409cdabcb", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e1fa513c-0cb3-475e-824e-3d860e6fafa1", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4c5c0bd-6986-4ede-b4ec-359a47525544", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc1ad02e-c65c-4619-ac0b-462be94f30ed", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "User Authentication OIDC Profile Infos", "description": "The `user-authentication-oidc-profile-info` object is the information object about the relationship between a [User Authentication Info](/docs/api/single-sign-on/user-authentication-infos) and an [OpenID Connect Profile](/docs/api/single-sign-on/oidc-profiles).\n", "item": [ { "id": "221e9369-1a5d-489b-8073-3c827941b6d8", "name": "Create User Authentication OIDC Profile Info", "request": { "name": "Create User Authentication OIDC Profile Info", "description": { "content": "Create OIDC profile information for a specific user authentication info.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6fc36268-b195-4bc3-930a-4aece259973e", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123/user-authentication-oidc-profile-info/def456\"\n }\n },\n \"links\": {\n \"self\": \"https://waCCvzQDqFOhPjCJfON.tsFvSCmgZRzZqvfmliiR.ye\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec241586-8d03-4180-aa81-4c5cf070862c", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cddaac5-b39f-41ed-a3dd-b3001964af89", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62bf5d1f-6bb7-487f-a987-370a871d2970", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fbe3f9e-b24c-4f28-8dd1-63fe25540a29", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5c99a796-4e6c-4a57-a2bb-702f8c09dc7d", "name": "Get User Authentication OIDC Profile Info", "request": { "name": "Get User Authentication OIDC Profile Info", "description": { "content": "Retrieve OIDC profile information for a specific user authentication info.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "57f6b5ed-4248-47a3-b039-41f347d89eb2", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"f1a2b3c4-d5e6-47f8-9a0b-c1d2e3f4a5b6\",\n \"type\": \"user_authentication_oidc_profile_info\",\n \"oidc_profile_id\": \"c8849022-c9c6-4888-9ca8-2bb78f445fb0\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://accounts.google.com\"\n },\n {\n \"id\": \"0a1b2c3d-4e5f-6071-8a9b-bc0d1e2f3a4b\",\n \"type\": \"user_authentication_oidc_profile_info\",\n \"oidc_profile_id\": \"21be087e-faa6-41fc-9b51-6763a363ec2d\",\n \"subject\": \"subject-456\",\n \"issuer\": \"https://appleid.apple.com\"\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-oidc-profile-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-oidc-profile-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03fd3fe7-7aa8-40ca-b5ee-e4b845e03d11", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d2c376d-3f24-4e3e-877a-cdf099db3a30", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d2e6e8d-b491-4dee-84c5-2c4882fe8ef1", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "02d12c40-fdee-499b-a370-5bc569a2dd1b", "name": "Get User Authentication OIDC Profile Info by ID", "request": { "name": "Get User Authentication OIDC Profile Info by ID", "description": { "content": "Retrieve specific OIDC profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0c405116-93ff-492f-89e6-bccdd384579d", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"f1a2b3c4-d5e6-47f8-9a0b-c1d2e3f4a5b6\",\n \"type\": \"user_authentication_oidc_profile_info\",\n \"oidc_profile_id\": \"c8849022-c9c6-4888-9ca8-2bb78f445fb0\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://accounts.google.com\"\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-oidc-profile-info/f1a2b3c4-d5e6-47f8-9a0b-c1d2e3f4a5b6\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "160d0509-24a7-4283-8d6a-8b3be7ffb0d6", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b000f0a6-bd61-4a5f-8a43-38066bc026aa", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aee55a91-0e13-464b-b050-2b1b82fef114", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc3cecfa-970b-4247-ade7-eeee47fef57b", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0739bbd6-a7c9-4283-9e45-84e09c0ac163", "name": "Update User Authentication OIDC Profile Info", "request": { "name": "Update User Authentication OIDC Profile Info", "description": { "content": "Update specific OIDC profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6be2e707-3bc5-48e3-a1c5-a84432d350ed", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123/user-authentication-oidc-profile-info/def456\"\n }\n },\n \"links\": {\n \"self\": \"https://waCCvzQDqFOhPjCJfON.tsFvSCmgZRzZqvfmliiR.ye\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "937cad23-1196-483e-b0c7-c198957f5459", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29dede05-83ea-4e62-acfd-1b21a89425ee", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25bce01d-901d-4b8f-9572-c7cf733c58a8", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dd4b88b-c237-474f-99f6-ce23c8bd0181", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"string\",\n \"oidc_profile_id\": \"f1a2932f-3579-46f0-92e1-a4a80cd26e37\",\n \"subject\": \"subject-123\",\n \"issuer\": \"https://test.issuer.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "440f44b3-c9a9-43eb-85ac-d9bf9c093234", "name": "Delete User Authentication OIDC Profile Info", "request": { "name": "Delete User Authentication OIDC Profile Info", "description": { "content": "Delete specific OIDC profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId", "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "59b6ae31-c956-46c5-a594-5ce5fe67b947", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "34353724-b915-44c8-acb0-ec69c47be0e0", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e776dc9a-200e-473a-a490-e4b7a8fef64a", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "613634d1-4279-4897-b9ab-ecfc7dc69b63", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8176739-466c-4b71-b9b1-8020886058c2", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-oidc-profile-info", ":oidcInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the OIDC profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "oidcInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "User Authentication Password Profile Infos", "description": "The `user-authentication-password-profile-info` object is the information object about the relationship between a [User Authentication Info](/docs/api/single-sign-on/user-authentication-infos) and a [Password Profile](/docs/api/single-sign-on/password-profiles) object.", "item": [ { "id": "b7fd7653-6fb8-4ee8-b3d0-404fa88dc0f7", "name": "Get User Authentication Password Profile Info List", "request": { "name": "Get User Authentication Password Profile Info List", "description": { "content": "Retrieve a list of password profile information for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7d1aec67-864f-47e4-a164-42d103bbf38a", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"9f8e7d6c-5b4a-3a2f-1e0d-c9b8a7f6e5d4\",\n \"type\": \"user_authentication_password_profile_info\",\n \"username\": \"uauppinamepestupdate@test.com\",\n \"password_profile_id\": \"a2f6d4c0-1d2b-4b3a-9e5a-2f4b1c7d8e9f\"\n },\n {\n \"id\": \"0c9b8a7f-6e5d-4c3b-2a1f-0e9d8c7b6a5f\",\n \"type\": \"user_authentication_password_profile_info\",\n \"username\": \"another.user@example.com\",\n \"password_profile_id\": \"b3e7f5a1-2c3d-4e4b-8f6a-3e5c2d8f9a0b\"\n }\n ],\n \"meta\": {\n \"results\": {\n \"total\": 2\n },\n \"page\": {\n \"limit\": 25,\n \"offset\": 0\n }\n },\n \"links\": {\n \"current\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-password-profile-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"first\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-password-profile-info?page%5Boffset%5D=0&page%5Blimit%5D=25\",\n \"last\": null,\n \"next\": null,\n \"prev\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f917bdf-0b60-43f3-8107-86ca25825e10", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "195571b4-adef-4304-b6d0-dee8ba81652d", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The number of records per page.", "type": "text/plain" }, "key": "page[limit]", "value": "25" }, { "disabled": false, "description": { "content": "The number of records to offset the results by.", "type": "text/plain" }, "key": "page[offset]", "value": "0" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cce85059-ad05-4afe-9ed6-65c1d19a6221", "name": "Create User Authentication Password Profile Info", "request": { "name": "Create User Authentication Password Profile Info", "description": { "content": "Create password profile information for a specific user authentication info.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dad4210a-1cda-4eaa-8ba8-71688cb70eda", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123/user-authentication-password-profile-info/def456\"\n }\n },\n \"links\": {\n \"self\": \"https://tIumuIzaBpATn.lpjpxNdsWXSUU+zFK-MDFLzoC1r.+xUYNlF9FSCJ-eVJI6.,jIKIiue57nraisRr6BVVD,umVrM1E\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4095cc9e-a679-4724-aaa1-aeb17c563867", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5311308-6a7b-4ff9-be9b-25e40e5cace0", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42786b9c-2e22-416d-af5f-abc49b936ff6", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "070935b5-5cdd-4b37-9b58-61acdc5f8488", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "74d98bf8-220c-499c-afca-ea73763fc0ac", "name": "Get User Authentication Password Profile Info by ID", "request": { "name": "Get User Authentication Password Profile Info by ID", "description": { "content": "Retrieve specific password profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId", "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a01eb9b9-2e83-4ccb-9a8d-72c8be092a7f", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"9f8e7d6c-5b4a-3a2f-1e0d-c9b8a7f6e5d4\",\n \"type\": \"user_authentication_password_profile_info\",\n \"username\": \"uauppinamepestupdate@test.com\",\n \"password_profile_id\": \"a2f6d4c0-1d2b-4b3a-9e5a-2f4b1c7d8e9f\"\n },\n \"links\": {\n \"self\": \"https://euwest.api.elasticpath.com/v2/authentication-realms/45928070-44a6-448b-8246-a85aa35320af/user-authentication-info/40c8ecfa-0d1a-43b2-8d62-2bbbb6c4207c/user-authentication-password-profile-info/9f8e7d6c-5b4a-3a2f-1e0d-c9b8a7f6e5d4\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f75282ab-29df-4e44-a032-00315e6f4e8b", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1def0f44-7fe4-4d2c-b800-c35c694245f3", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b77fd04-3d16-4c7f-9227-71af6ce1ba4e", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36c30dc4-bd94-4947-8b9a-390115c08c2a", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "141fbe95-cdfa-43e7-a8e9-99dde66a5217", "name": "Update User Authentication Password Profile Info", "request": { "name": "Update User Authentication Password Profile Info", "description": { "content": "Update specific password profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId", "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f826f41f-68a7-4495-a323-97ac6cf06007", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"id\": \"deb6b25f-8451-4211-9a22-95610333df23\",\n \"meta\": {\n \"created_at\": \"2021-02-23T09:40:33.882Z\",\n \"updated_at\": \"2021-02-23T09:40:33.882Z\"\n },\n \"links\": {\n \"self\": \"https://useast.api.elasticpath.com/v2/authentication-realms/deb6b25f-8451-4211-9a22-95610333df23/user-authentication-info/abc123/user-authentication-password-profile-info/def456\"\n }\n },\n \"links\": {\n \"self\": \"https://tIumuIzaBpATn.lpjpxNdsWXSUU+zFK-MDFLzoC1r.+xUYNlF9FSCJ-eVJI6.,jIKIiue57nraisRr6BVVD,umVrM1E\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94aba5b7-99dd-4649-b94b-6821429c3fd3", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1049ca7f-213c-421d-aece-26a284469da6", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76186820-c3cf-4170-8e08-3a75101e83b6", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "690246ad-64cb-4eed-ade8-422312cd8ebe", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"password\": \"P@ssw0rd123!\",\n \"password_profile_id\": \"767e6763-014e-4b6e-8a0e-59b863ab3262\",\n \"type\": \"string\",\n \"username\": \"uauppinamepestupdate@test.com\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a106b844-75db-4343-9073-c371a0cc7c57", "name": "Delete User Authentication Password Profile Info", "request": { "name": "Delete User Authentication Password Profile Info", "description": { "content": "Delete specific password profile information by ID for a user.", "type": "text/plain" }, "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId", "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId", "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "d41b3ec1-0b82-4d79-a24a-9c05030e33f0", "name": "No Content", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1fd4b177-f3a1-40a6-9637-c3df115a3303", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Bad Request\",\n \"status\": \"400\",\n \"detail\": \"Validation failed: field 'Name' on the 'min' tag.\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23e006df-20b7-4806-a56e-f2d445604e12", "name": "Not Found", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"Resource not found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a923570a-94d1-4989-8c38-1f8c0c39e946", "name": "Unprocessable Entity", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Entity\",\n \"status\": \"422\",\n \"detail\": \"Constraint violation\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cbdf82b-f1c9-4789-884d-8ca71ae73b57", "name": "Internal server error.", "originalRequest": { "url": { "path": [ "v2", "authentication-realms", ":realmId", "user-authentication-info", ":userAuthInfoId", "user-authentication-password-profile-info", ":passwordProfileInfoId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" }, { "disabled": false, "description": { "content": "(Required) The ID of the user authentication info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "userAuthInfoId" }, { "disabled": false, "description": { "content": "(Required) The ID of the password profile info.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "passwordProfileInfoId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\",\n \"detail\": \"there was a problem processing your request\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "OIDC Authentication", "description": "The OIDC IDP Login endpoints handle the initiation of OpenID Connect authentication flows.\n\nWhen a user needs to authenticate via OIDC, they are redirected to these endpoints which then redirect them to the configured OIDC provider for authentication.\n", "item": [ { "id": "8ee891cf-516b-447c-a1a5-196a821f42c2", "name": "Initiate OIDC Login", "request": { "name": "Initiate OIDC Login", "description": { "content": "Initiate the OIDC login flow for a specific store and authentication realm\n::: note This is not an **API Endpoint**, but the [Authentication Request](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest) of the OpenID Connect Authentication Flow.\nTo initiate an OpenID Connect authentication you must change the location in the Browser to this URL, not call it asynchronously. :::", "type": "text/plain" }, "url": { "path": [ "oidc-idp", "login", "stores", ":storeId", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The Client ID, for Account Management Authentication see the `meta.client_id` field on [Account Authentication Settings](/docs/api/accounts/get-v-2-settings-account-authentication).", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Redirection URI to which the response will be sent. Must exactly match a pre-registered redirect URI for the client in the `redirect_uris` of the [Authentication Realm](/docs/api/single-sign-on/get-v-2-authentication-realms-realm-id).", "type": "text/plain" }, "key": "redirect_uri", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" }, { "disabled": false, "description": { "content": "(Required) OIDC/OAuth 2.0 response type, this must be \"code\" in Commerce.", "type": "text/plain" }, "key": "response_type", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Space-delimited list of scopes. Must include \"openid\", \"email\", and \"name\".", "type": "text/plain" }, "key": "scope", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Opaque value used to maintain state between the request and the callback. Helps prevent CSRF.", "type": "text/plain" }, "key": "state", "value": "string" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) transformation method that was used to derive code_challenge. (This can only be one of S256,plain)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) Code Challenge.", "type": "text/plain" }, "key": "code_challenge", "value": "string" }, { "disabled": false, "description": { "content": "Space-delimited, case-sensitive list that specifies whether the Authorization Server prompts the End-User for re-authentication and consent. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "prompt", "value": "string" }, { "disabled": false, "description": { "content": "ASCII string value that specifies how the Authorization Server displays the authentication and consent user interface. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "display", "value": "string" }, { "disabled": false, "description": { "content": "End-User's preferred languages and scripts for the user interface, represented as space-separated list of BCP47 language tag values. This value is forwarded to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "ui_locales", "value": "fr-CA fr en" }, { "disabled": false, "description": { "content": "(Required) Selects the specific OIDC Profile within the realm to use for authentication.", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" }, { "disabled": false, "description": { "content": "Custom boolean flag. If true, if the user attempts to hit back in their browser, we will redirect them back to the store front", "type": "text/plain" }, "key": "ep_report_callback_replay_error", "value": "true" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId", "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c51df710-386e-4c8b-b53a-cee06d3ee970", "name": "See Other - Redirects to the IdP provider for authentication", "originalRequest": { "url": { "path": [ "oidc-idp", "login", "stores", ":storeId", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The Client ID, for Account Management Authentication see the `meta.client_id` field on [Account Authentication Settings](/docs/api/accounts/get-v-2-settings-account-authentication).", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Redirection URI to which the response will be sent. Must exactly match a pre-registered redirect URI for the client in the `redirect_uris` of the [Authentication Realm](/docs/api/single-sign-on/get-v-2-authentication-realms-realm-id).", "type": "text/plain" }, "key": "redirect_uri", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" }, { "disabled": false, "description": { "content": "(Required) OIDC/OAuth 2.0 response type, this must be \"code\" in Commerce.", "type": "text/plain" }, "key": "response_type", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Space-delimited list of scopes. Must include \"openid\", \"email\", and \"name\".", "type": "text/plain" }, "key": "scope", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Opaque value used to maintain state between the request and the callback. Helps prevent CSRF.", "type": "text/plain" }, "key": "state", "value": "string" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) transformation method that was used to derive code_challenge. (This can only be one of S256,plain)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) Code Challenge.", "type": "text/plain" }, "key": "code_challenge", "value": "string" }, { "disabled": false, "description": { "content": "Space-delimited, case-sensitive list that specifies whether the Authorization Server prompts the End-User for re-authentication and consent. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "prompt", "value": "string" }, { "disabled": false, "description": { "content": "ASCII string value that specifies how the Authorization Server displays the authentication and consent user interface. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "display", "value": "string" }, { "disabled": false, "description": { "content": "End-User's preferred languages and scripts for the user interface, represented as space-separated list of BCP47 language tag values. This value is forwarded to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "ui_locales", "value": "fr-CA fr en" }, { "disabled": false, "description": { "content": "(Required) Selects the specific OIDC Profile within the realm to use for authentication.", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" }, { "disabled": false, "description": { "content": "Custom boolean flag. If true, if the user attempts to hit back in their browser, we will redirect them back to the store front", "type": "text/plain" }, "key": "ep_report_callback_replay_error", "value": "true" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId" }, { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "See Other", "code": 303, "header": [ { "disabled": false, "description": { "content": "The URL of the IdP provider to redirect to", "type": "text/plain" }, "key": "Location", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" } ], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e990c68b-88d9-444a-abd2-8066101e28a8", "name": "Temporary Redirect - Redirects the user back to the caller.", "originalRequest": { "url": { "path": [ "oidc-idp", "login", "stores", ":storeId", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The Client ID, for Account Management Authentication see the `meta.client_id` field on [Account Authentication Settings](/docs/api/accounts/get-v-2-settings-account-authentication).", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Redirection URI to which the response will be sent. Must exactly match a pre-registered redirect URI for the client in the `redirect_uris` of the [Authentication Realm](/docs/api/single-sign-on/get-v-2-authentication-realms-realm-id).", "type": "text/plain" }, "key": "redirect_uri", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" }, { "disabled": false, "description": { "content": "(Required) OIDC/OAuth 2.0 response type, this must be \"code\" in Commerce.", "type": "text/plain" }, "key": "response_type", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Space-delimited list of scopes. Must include \"openid\", \"email\", and \"name\".", "type": "text/plain" }, "key": "scope", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Opaque value used to maintain state between the request and the callback. Helps prevent CSRF.", "type": "text/plain" }, "key": "state", "value": "string" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) transformation method that was used to derive code_challenge. (This can only be one of S256,plain)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) Code Challenge.", "type": "text/plain" }, "key": "code_challenge", "value": "string" }, { "disabled": false, "description": { "content": "Space-delimited, case-sensitive list that specifies whether the Authorization Server prompts the End-User for re-authentication and consent. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "prompt", "value": "string" }, { "disabled": false, "description": { "content": "ASCII string value that specifies how the Authorization Server displays the authentication and consent user interface. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "display", "value": "string" }, { "disabled": false, "description": { "content": "End-User's preferred languages and scripts for the user interface, represented as space-separated list of BCP47 language tag values. This value is forwarded to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "ui_locales", "value": "fr-CA fr en" }, { "disabled": false, "description": { "content": "(Required) Selects the specific OIDC Profile within the realm to use for authentication.", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" }, { "disabled": false, "description": { "content": "Custom boolean flag. If true, if the user attempts to hit back in their browser, we will redirect them back to the store front", "type": "text/plain" }, "key": "ep_report_callback_replay_error", "value": "true" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId" }, { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Temporary Redirect (since HTTP/1.1)", "code": 307, "header": [ { "disabled": false, "description": { "content": "The location to redirect to, typically the store front.", "type": "text/plain" }, "key": "Location", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" } ], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a3019c2d-ca9d-4050-bbc4-01162f0aa617", "name": "In some cases the OAuth 2.0 specification does not permit us to redirect the user back to the caller, in which case they will see a 4xx.", "originalRequest": { "url": { "path": [ "oidc-idp", "login", "stores", ":storeId", "authentication-realms", ":realmId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) The Client ID, for Account Management Authentication see the `meta.client_id` field on [Account Authentication Settings](/docs/api/accounts/get-v-2-settings-account-authentication).", "type": "text/plain" }, "key": "client_id", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Redirection URI to which the response will be sent. Must exactly match a pre-registered redirect URI for the client in the `redirect_uris` of the [Authentication Realm](/docs/api/single-sign-on/get-v-2-authentication-realms-realm-id).", "type": "text/plain" }, "key": "redirect_uri", "value": "https://BexQZiiJloh.xwtEqUZyZWJnpUw8YP" }, { "disabled": false, "description": { "content": "(Required) OIDC/OAuth 2.0 response type, this must be \"code\" in Commerce.", "type": "text/plain" }, "key": "response_type", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Space-delimited list of scopes. Must include \"openid\", \"email\", and \"name\".", "type": "text/plain" }, "key": "scope", "value": "string" }, { "disabled": false, "description": { "content": "(Required) Opaque value used to maintain state between the request and the callback. Helps prevent CSRF.", "type": "text/plain" }, "key": "state", "value": "string" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) transformation method that was used to derive code_challenge. (This can only be one of S256,plain)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" }, { "disabled": false, "description": { "content": "(Required) [Proof Key for Code Exchange (PKCE)](https://datatracker.ietf.org/doc/html/rfc7636) Code Challenge.", "type": "text/plain" }, "key": "code_challenge", "value": "string" }, { "disabled": false, "description": { "content": "Space-delimited, case-sensitive list that specifies whether the Authorization Server prompts the End-User for re-authentication and consent. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "prompt", "value": "string" }, { "disabled": false, "description": { "content": "ASCII string value that specifies how the Authorization Server displays the authentication and consent user interface. This value is passed to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "display", "value": "string" }, { "disabled": false, "description": { "content": "End-User's preferred languages and scripts for the user interface, represented as space-separated list of BCP47 language tag values. This value is forwarded to the configured IdP. See [Section 3.1.2.1. Authentication Request - OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest).", "type": "text/plain" }, "key": "ui_locales", "value": "fr-CA fr en" }, { "disabled": false, "description": { "content": "(Required) Selects the specific OIDC Profile within the realm to use for authentication.", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" }, { "disabled": false, "description": { "content": "Custom boolean flag. If true, if the user attempts to hit back in their browser, we will redirect them back to the store front", "type": "text/plain" }, "key": "ep_report_callback_replay_error", "value": "true" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId" }, { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"invalid_request\",\n \"errorDescription\": \"The field [client_id] with value [unknownClient] is invalid.\",\n \"error_description\": \"The field [client_id] with value [unknownClient] is invalid.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aa28fb31-d5d1-43ad-b6d2-40e7260796b4", "name": "OpenID Connect Discovery", "request": { "name": "OpenID Connect Discovery", "description": { "content": "Returns the OpenID Connect discovery document for the authentication realm.\nThis endpoint provides metadata about the OIDC provider's configuration, including endpoints, supported features, and capabilities. Some libraries might require an OIDC discovery document in order to work.\nFor more information see [OpenID Connect Discovery 1.0](https://openid.net/specs/openid-connect-discovery-1_0.html)", "type": "text/plain" }, "url": { "path": [ "oidc-idp", "stores", ":storeId", "authentication-realms", ":realmId", ".well-known", "openid-configuration" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The ID of the [OIDC profile](/docs/api/single-sign-on/oidc-profiles) that you would like to authenticate with", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" } ], "variable": [ { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId", "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" } }, { "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId", "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0cf60c86-208d-4cfe-9d7f-520ad076c63c", "name": "OK - OpenID Connect discovery document", "originalRequest": { "url": { "path": [ "oidc-idp", "stores", ":storeId", "authentication-realms", ":realmId", ".well-known", "openid-configuration" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The ID of the [OIDC profile](/docs/api/single-sign-on/oidc-profiles) that you would like to authenticate with", "type": "text/plain" }, "key": "elasticpath_commerce_cloud_profile_id", "value": "2567a614-49a1-3a05-8926-a761b612076d" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The ID of the store.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "storeId" }, { "disabled": false, "description": { "content": "(Required) The ID of the authentication realm.", "type": "text/plain" }, "type": "any", "value": "2567a614-49a1-3a05-8926-a761b612076d", "key": "realmId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"authorization_endpoint\": \"http://euwest.api.elasticpath.com/oidc-idp/login/stores/88888888-4444-4333-8333-111111111111/authentication-realms/45928070-44a6-448b-8246-a85aa35320af\",\n \"id_token_signing_alg_values_supported\": [\n \"RS256\"\n ],\n \"issuer\": \"http://euwest.api.elasticpath.com/oidc-idp/stores/88888888-4444-4333-8333-111111111111/authentication-realms/45928070-44a6-448b-8246-a85aa35320af\",\n \"jwks_uri\": \"http://euwest.api.elasticpath.com/oidc-idp/.well-known/jwks.json\",\n \"response_types_supported\": [\n \"code\"\n ],\n \"scopes_supported\": [\n \"profile\",\n \"openid\",\n \"email\"\n ],\n \"subject_types_supported\": [\n \"public\"\n ],\n \"token_endpoint\": \"http://euwest.api.elasticpath.com/oidc-idp/token/stores/88888888-4444-4333-8333-111111111111/authentication-realms/45928070-44a6-448b-8246-a85aa35320af\",\n \"token_endpoint_auth_methods_supported\": \"client_secret_basic\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Features", "description": "A feature indicates some benefit that is received as a result of having an active subscription. This translates to tags being applied to the subscriber's account allowing access to some resource to be controlled.\n\nThere are three types of feature - `access`, `promotion`, and `usage`.\n\nThe `access` feature is designed to simply give access to some resource, for example a streaming service. If its tag is present on the subscriber's account then access to that resource should be provided.\n\nThe `promotion` feature coupled with the [promotions service](/docs/promotions-builder/overview) allows subscribers to get access to a specific promotion. This is achieved using a tag which is used as a constraint on the promotion. A promotion feature may have multiple promotions associated with it, but just one must be selected when configuring the feature for an offering's plan.\n\n The `usage` feature is designed to measure some sort of usage of a resource. This currently relies on [commerce extensions](/docs/api/commerce-extensions/commerce-extensions-introduction) to manage usage.\n\n Once defined a feature may be attached to an offering, making it available for use with any of that offering's plans. Once attached it must be configured for each of the offering's plans it is applicable to. For the `promotion` feature this involves specifying which of that feature's tags, and hence which promotion, should be applied when subscribed to that offering. Similarly, for the `promotion` feature the default value for the usage metric must be supplied.\n", "item": [ { "id": "43c34890-5821-4bd4-a702-be06e46621f9", "name": "Create a feature", "request": { "name": "Create a feature", "description": {}, "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "658fbf56-691c-49be-9855-dfdfcbc18de5", "name": "Success. The feature is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac3b21fe-afd3-4cb7-a748-1128d1c4ff75", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2eea022-4230-466e-bee3-dc2e7279b123", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "10c19767-7953-4fa7-888f-020c5f0a253a", "name": "List features", "request": { "name": "List features", "description": { "content": "Retrieves a list of all subscription features.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `external_ref` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `eq` | `tag` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `external_ref`, `tag` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b6d897b2-4d37-4840-99bd-e8f8b831a673", "name": "Success. A list of features is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64c125b1-2f6d-4523-a586-38544d642383", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9e50344-305d-4582-8405-5512eaa57895", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a311f72c-f6af-4742-930d-5f606a524f30", "name": "Get feature", "request": { "name": "Get feature", "description": {}, "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ddb35ca9-8d57-437c-b4d3-ad0ebc3e79c6", "name": "Success. The feature details are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f89a49f6-d0e1-4bc4-9e60-0dc2b8740afb", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa186f59-2b4e-4ead-a657-62cdce664640", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "744c4e97-e090-4b09-a578-c202a4a729c3", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "20db5f8f-9fcc-4114-bf0a-ab017ad71522", "name": "Delete feature", "request": { "name": "Delete feature", "description": { "content": "Remove a feature.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "86e6fdbb-8518-4d25-b5ff-65fcd10cda22", "name": "Success. The feature is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4b4152ab-0499-4394-8fa2-9f0f02893319", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6acdd56b-96bc-42b7-b888-07b66e2457eb", "name": "Update a feature", "request": { "name": "Update a feature", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the feature is not updated. For fields that are optional, an existing value can be removed by specifying a value of null.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "aaedb43b-b6da-4ac2-b5dd-5b0566c70b6f", "name": "Success. The feature details are updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fdfaa32-864b-4ce9-8a59-a7fe12b1016b", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f43ef93-c3e4-44ce-886c-0f78e672486f", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a053a229-46ae-4686-ad89-793be9c49977", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7441438b-987c-4a86-8fcc-777e37d90cc2", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b0479a0-8367-458f-af94-df5dbc9f59cd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Offerings", "description": "An offering is a combination of plans and pricing options; plans are combined with one or more pricing options to form an offering. \n\nFor example, your company provides online\n streaming of movies, web-series, and music. Your customers can purchase these services through either a weekly or monthly pricing option.\n\nOffering plans can be either:\n\n- a subscription plan, created within an offering.\n- a Product Experience Manager product, see [**Create a product**](/docs/api/pxm/products/create-product)\n\n### Offering Examples\n\nOfferings can have any combination of plans and pricing options. The pricing of an offering is determined by the pricing you have configured for your plans and pricing options.\n\n| Example | Plan | Pricing options | Offering |\n| --- | --- | --- | --- |\n| Single plan and pricing option | One plan with a plan price of $50 | A monthly pricing option with a 5% discount | An offering with a monthly pricing option for $47.50 a month |\n| Single plan with multiple pricing options | One plan with a plan price of $50 |
  • A monthly pricing option with a 5% discount
  • A yearly pricing option with a 10% discount
| An offering with two pricing options:
  • A monthly pricing option for $47.50 a month
  • A yearly pricing option for $45 a month
|\n| Multiple plans and pricing option | Two plans:
  • One plan with a plan price of $50.
  • One plan with a plan price of $75.
| A monthly pricing option with a 5% discount. | An offering with a monthly pricing option for $118.75 a month. | \n| Multiple plans with multiple pricing options | Two plans:
  • One plan with a plan price of $50.
  • One plan with a plan price of $75.
|
  • A monthly pricing option with a 5% discount
  • A yearly pricing option with a 10% discount
| An offering with two pricing options:
  • A monthly pricing option for $118.75 a month
  • A yearly pricing option for $112.50 a month
| \n\n### Building an Offering\n\nWhen you are building an offering:\n\n- you can create new pricing options and plans.\n- you can modify existing plans and pricing options. For example, you can modify the plan price or any attributes of a pricing option included in the offering.\n\nHere's how you build an offering:\n\nWhen [**building your offerings**](/docs/api/subscriptions/build-offering) you must supply the plans and pricing options that a customer can choose. An offering can consist of many combinations of a plan or pricing options, depending on the plans and services you offer.\n\nPlans can either be subscription plans or Product Experience Manager products. To create a Product Experience Manager product, see [**Create a product**](/docs/api/pxm/products/create-product)\n\nPricing options are the rules that govern your subscription, for example, any discount. \n - You can combine and reuse pricing options for as many plans as you want, making it quick and easy to create your subscription offerings. \n - An offering must have at least one pricing option.\n - Each plan must have the appropriate pricing option associated with it\n\nWhen a [**customer**](/docs/api/subscriptions/subscribers) chooses a plan and pricing option, a subscription is created. See [**Subscriptions**](/docs/api/subscriptions/subscriptions). Elastic Path Subscriptions manages the billing and recurring payments associated with the subscription. See [**Invoicing and Billing**](/docs/api/subscriptions/jobs).\n\n### Editing Offerings\n\nAfter saving an offering, you can, at any time:\n\n- update an offering's details, for example, name or description. See [**Update an Offering**](/docs/api/subscriptions/update-offering).\n- update an existing plan in an offering. See [**Update a plan in an offering**](/docs/api/subscriptions/update-offering-plan)\n- add a new plan in an offering. See [**Create a plan inside an offering**](/docs/api/subscriptions/create-offering-plan)\n- remove plans. See [**Remove a plan from an offering**](/docs/api/subscriptions/delete-offering-plan).\n- update an existing pricing option in an offering. See [**Update a pricing option in an offering**](/docs/api/subscriptions/update-offering-pricing-option)\n- add a new pricing option to an offering. See [**Create a pricing option inside an offering**](/docs/api/subscriptions/create-offering-pricing-option).\n- remove pricing options. See [**Removing a pricing option from an offering**](/docs/api/subscriptions/delete-offering-plan).\n\nAny modifications that you make to offerings, and plans or pricing options in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.\n", "item": [ { "id": "872bd27e-f27b-4509-a7ec-8ecfe2d1a949", "name": "Create an offering", "request": { "name": "Create an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"relationships\": {\n \"proration_policy\": {\n \"type\": \"subscription_proration_policy\",\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "11ae5133-9c68-439b-919b-b7eff742f02c", "name": "Success. The offering is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"relationships\": {\n \"proration_policy\": {\n \"type\": \"subscription_proration_policy\",\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "615f16c7-19c3-48a0-ab21-c03105696a57", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"relationships\": {\n \"proration_policy\": {\n \"type\": \"subscription_proration_policy\",\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4904f45d-1bed-4837-8c0e-21409b2cac67", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"relationships\": {\n \"proration_policy\": {\n \"type\": \"subscription_proration_policy\",\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1061b901-66d4-4faf-946e-769d247ab72f", "name": "List offerings", "request": { "name": "List offerings", "description": { "content": "Retrieves a list of all subscription offerings.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `external_ref`, `plans.external_ref`, `proration_policy_id` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `external_ref`, `plans.external_ref`, `proration_policy_id` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "bd8353ce-31e0-4210-ba2c-36c455109f28", "name": "Success. A list of offerings is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"included\": {\n \"features\": [\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"plans\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n },\n \"key_4\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "702fdd44-d151-4149-85b9-3224d0a00bff", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a6b748b-fc8d-4959-9c76-89612c1d3884", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "78f7220f-6934-461c-9629-5eb7135efdc0", "name": "Build an offering", "request": { "name": "Build an offering", "description": { "content": "An offering includes plans and pricing options; plans are combined with one or more pricing options to form an offering. An offering can include either:\n\n- subscription plans (created within an offering).\n- Product Experience Manager products. See [**create a product**](/docs/api/pxm/products/create-product).\n\nWhen you are building an offering:\n\n- you can create new pricing options and plans.\n- you can modify an existing plan and pricing options. For example, you can modify the plan price or any attributes of a pricing option included in the offering.\n\nHere's how you build an offering:\n\n1. Specify the plan to build with the offering. A plan can be:\n\n - subscription plans. Specify the subscription plan attributes. \n - Product Experience Manager products. Specify the Product Experience Manager product ID in `external_ref` in `PlanAttributes`. For the remaining plan attributes, you can specify their values to match the values of the existing Product Experience Manager product attributes. However, you can also specify different values, depending on your requirements.\n\n2. Specify the pricing options to build with the offering. Pricing options are the rules that govern your subscription, for example, any discount. You can combine and reuse pricing options for as many plans as you want, making it quick and easy to create your subscription offerings.\n An offering must have at least one pricing option. \n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Magazine\",\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n ],\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"key_1\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n },\n \"key_2\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"features\": [\n \"abc123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1202cea3-39f2-4ae4-be0b-bb1db11926b8", "name": "Success. The new subscription offering is created with the specified subscription plans and pricing options attached to the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Magazine\",\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n ],\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"key_1\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n },\n \"key_2\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"features\": [\n \"abc123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6417a21c-c530-4d28-afb8-57c3f5d29ff2", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Magazine\",\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n ],\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"key_1\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n },\n \"key_2\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"features\": [\n \"abc123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "886558a9-b653-4c6e-9475-c8532ac40174", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", "build" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"name\": \"Magazine\",\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n ],\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"key_1\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n },\n \"key_2\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"features\": [\n \"abc123\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6a61cbf2-a238-4063-bab0-c7a0f94ca515", "name": "Get offering", "request": { "name": "Get offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fc9a1092-be21-404c-9b67-a61556f6b048", "name": "Success. The details of the subscription offering are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"included\": {\n \"features\": [\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"plans\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe33a24a-197e-4c53-a14c-09431598d2b4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b88307d-c465-44bf-85c2-dc01d7b1f993", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e47ba4a-c80f-4b52-af20-bda29b45a988", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2a2343de-5bce-4916-a3e6-7b222b9025d5", "name": "Delete offering", "request": { "name": "Delete offering", "description": { "content": "When a subscription is created, it creates a snapshot of the offering. This means you can delete an offering without affecting any active subscriptions.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "3a1aa227-c161-4556-be84-e953179f48e8", "name": "Success. The subscription offering is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "db839748-cf96-4fc2-b6c0-2092a70b6be5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0944a6d0-d029-4838-9e9d-7fd9aa33e9d7", "name": "Update an offering", "request": { "name": "Update an offering", "description": { "content": "After saving an offering, you can update an offering at any time. Updating an offering does not affect any active subscriptions. The changes take effect on all new subscriptions that are created. For fields that are optional, an existing value can be removed by specifying a value of null.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9fed23a6-d7dc-416d-a1a9-88ba6d447a4c", "name": "Success. The details of the subscription offering are updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a41b021-0523-46db-bb02-5eb7438e3db9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e4be80c-7035-4f88-b067-066655ef6452", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4ee9e9b-5311-493d-a479-c767dd011d26", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbce1c58-8141-47ef-b28e-82498b7f87ea", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10ac9782-0c3a-4490-99f6-ba3730f77a76", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"attributes\": 1090.3834405592993\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "28d3c56b-5ad2-43ce-8d77-2984064ab59f", "name": "Get a feature in an offering", "request": { "name": "Get a feature in an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d96dd81a-90df-4f65-b5fe-432684b26dcc", "name": "Success. The details of the feature are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe891d09-d33d-4606-bf77-bf59f66bd1d7", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "daa01cc2-9ee4-4365-bc28-d8d1b2b397ac", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "725b797e-cc72-41fc-829f-9879870f29df", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e432046c-d46a-4835-bd32-da6788e87db4", "name": "Updates a feature in an offering", "request": { "name": "Updates a feature in an offering", "description": { "content": "Use the unique identifier of the feature in the offering that you want to update. Any modifications that you make to the features in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2daa0ac2-c710-4ccb-9db1-330b4b948faf", "name": "Success. The feature details are updated on the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "233027f0-a151-49a8-a976-8d4b90241879", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5d21f5d-bcff-4ecd-8ec9-b9cf06ace81b", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "87f10ddd-1dea-4b45-b394-67e53607c821", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60284eac-af03-4803-a147-2d5657c3029f", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43179f88-dffc-43a9-a31c-88e20a60d457", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Digital library access\",\n \"description\": \"Access to over 100 ebooks via the digital library.\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2d15935c-35cc-46e6-85b7-5afabe839d91", "name": "Remove a feature from an offering", "request": { "name": "Remove a feature from an offering", "description": { "content": "After saving an offering, you can remove features from it at any time.\n\n Removing a feature from an offering does not affect any existing active subscriptions. The changes take effect on all new subscriptions that are created.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "8945bbe0-1e1d-4f76-9308-1c8ebe3eb626", "name": "Success. The subscription feature is removed from the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b37e523f-6aaf-4e32-a668-d1188a5e574f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10305e1a-6000-4958-ae1b-7c4b52108029", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b2dc813-ab3a-4f82-8f3d-086b463e0d41", "name": "Attach a feature", "request": { "name": "Attach a feature", "description": { "content": "After saving an offering, you can attach new features to it at any time.\n\nAdding new features does not affect any existing active subscriptions. The changes take effect on all new subscriptions that are created.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7db50bb7-3456-4165-97ee-8e551d8d4a87", "name": "Success. The subscription feature is attached with the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfbb3566-eb29-42cf-8006-147725aaa228", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79303e01-fddd-48b1-8773-9d68688395d6", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d39ea7cf-691b-48b8-aaec-e4f941094f1b", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0310edfc-0621-4b70-87d0-1e541c14fb8e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features", "attach" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"features\": [\n \"11111111-2222-3333-4444-555555555555\"\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bc3c1301-38a6-4951-a763-21861efae447", "name": "List an offering's pricing options", "request": { "name": "List an offering's pricing options", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9c5bc3dd-dc03-4d70-bb06-4cbdeeee99b0", "name": "Success. A list of pricing options attached with the offering is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64e89240-71e5-4f32-8294-4ed416a9c58d", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "793e659a-fa1c-42bc-97a1-aab0b9720ef0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6792bb8d-be5e-4c88-b9e8-4c2d7443dfbf", "name": "Create a pricing option inside an offering", "request": { "name": "Create a pricing option inside an offering", "description": { "content": "After saving an offering, you can add new pricing option to it at any time.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "dc6d0a85-9533-4821-8add-994248e2745a", "name": "Success. The pricing option is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8364f637-5579-43b2-967f-6e3e26650027", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c63f376b-0be8-4334-aff3-b974b81717ad", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "662ef208-5887-428f-a7be-45b4bfa1e19b", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8d977a6-4dae-42e6-837e-63f834c6be22", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9107d75-0148-425b-9524-5494cbd6db68", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d6b522a2-73fb-4ce5-916e-44abe4f672a9", "name": "Get a pricing option in an offering", "request": { "name": "Get a pricing option in an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "628b5d59-3e0e-4491-8b3d-a6af05ff0b0f", "name": "Success. The details of the pricing option are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2898009-d8f8-4288-b4c7-562d91eb4d5a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ed9bbb0-1aee-4b8d-bf4e-fc50da21c48e", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad445b8e-8b7d-438e-842f-c90e4120ae3f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b7604f11-c4c5-4f92-b9db-ad32c2e6c87b", "name": "Update a pricing option in an offering", "request": { "name": "Update a pricing option in an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "864d1c9b-ca30-4fef-8b97-c2979c504740", "name": "Success. The pricing option details are updated on the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b552948-1b83-49d7-830a-f604150e8a19", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c3efcab-917e-4290-8ddd-c7580c324bc0", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a04875e-b04c-4327-af2f-ee33b753af26", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c0121b0-2d7e-42e0-b455-e84326fe9b4d", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "447d2620-6fc6-4662-992e-d0e3fc27c2b8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Monthly\",\n \"description\": \"A monthly subscription.\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"trial_period\": 7,\n \"plan_length\": 12,\n \"lead_time\": {\n \"type\": \"week\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a29abbca-06e1-4bf1-8059-d6361d4bd913", "name": "Remove a pricing option from an offering", "request": { "name": "Remove a pricing option from an offering", "description": { "content": "After saving an offering, you can remove pricing options from it at any time.\n\nRemoving a pricing option from an offering does not affect any existing active subscriptions. The changes take effect on all new subscriptions that are created.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "ed32b807-9e9c-465a-ac41-a276dbd5bbe7", "name": "Success. The subscription pricing option is no longer associated with the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "18604c99-a0fd-4a6f-961c-e01c454d8af9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5919e11e-d5eb-4aa3-87bc-30e1534f3c21", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "22aca9f4-5de8-464a-a6da-69e808b92d37", "name": "List an offering's features", "request": { "name": "List an offering's features", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "1b75c452-6ae3-4e65-b84a-4d74cf41c39c", "name": "Success. A list of subscription features attached to the offering is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86037c05-4e65-4d4d-b39e-629e1796686f", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e476d3b9-b108-4762-a87c-f083c129d357", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6799dec6-64ad-4efc-a457-236931779fb6", "name": "Create a feature directly inside an offering", "request": { "name": "Create a feature directly inside an offering", "description": { "content": "After saving an offering, you can add new features to it at any time.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8182b82c-cde7-4858-8c66-78e9329ffa8e", "name": "Success. The feature is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acde52d3-7e9a-4b24-be45-d777eef8c4aa", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbdd2dc9-04e3-40d4-9ce3-4218d956bd22", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e793140-fa98-4f6b-b664-4ac435bea5f2", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ea3fa5a-2472-43d9-ae29-0d76f4b98afa", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ecf3cbe5-f5d6-46ab-9702-d9303f804617", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c1362cdb-68e0-4cfe-9a00-f1a987718dcb", "name": "List an offering's plans", "request": { "name": "List an offering's plans", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cdd72218-5d2b-4d84-89b9-c3ebaaa69f14", "name": "Success. A list of subscription plans attached to the offering is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\",\n \"key_2\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e56cf62-4dac-42c8-a95e-078fc4a7026e", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a26ec167-a4ab-4fbe-9215-776cd24fc127", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "74630c78-3241-4410-a6be-d36cae2ce8f1", "name": "Create a plan inside an offering", "request": { "name": "Create a plan inside an offering", "description": { "content": "After saving an offering, you can add new plans to it at any time.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "ac80d3ac-1a17-41ff-baf9-5a13f52c726c", "name": "Success. The plan is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62732557-fe10-4a2a-bbbb-0bd5aa592e48", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "362c757a-8940-41db-a2c5-a8c4d8beaa9b", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd303637-abc5-419e-8cdb-55ae98b3709c", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1b519e6-7fc7-4900-b622-60307d7995fe", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3817702a-c361-4428-93ba-31fad1446210", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f82f4219-45a9-471e-8a2d-571667a0f914", "name": "Get a plan in an offering", "request": { "name": "Get a plan in an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "06ab8b57-a5b5-4c59-bb85-165f778bc3eb", "name": "Success. The details of the plan are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e56ed17-e126-4c77-80bf-e5d130522892", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3acc8a2-5b12-44a1-b772-aa2663832aef", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eca21f46-c4ed-452d-8335-b815f1379f4d", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "98ea5496-51b0-4b04-8cb1-412511828ca1", "name": "Update a plan in an offering", "request": { "name": "Update a plan in an offering", "description": { "content": "Use the unique identifier of the plan in the offering that you want to update. Any modifications that you make to the plans in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "76ddd3f8-f8e2-4cba-a387-5317fef7dcab", "name": "Success. The plan details are updated on the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7fdd9df9-9050-4129-92f0-d96ed55188fd", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "523c50d0-c857-4de7-b4d0-7fdc0ae7618b", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bcac818f-042a-4101-9caa-59bae6a911ef", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e49e19c-98a0-42d0-8eea-f8b851b5aea4", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "988345a1-c461-40dd-a606-879e9b4d2e28", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Magazine\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "579babd9-2ddd-4cd3-9685-c696bddedd68", "name": "Remove a plan from an offering", "request": { "name": "Remove a plan from an offering", "description": { "content": "After saving an offering, you can remove plans from it at any time.\n\n Removing a plan from an offering does not affect any existing active subscriptions. The changes take effect on all new subscriptions that are created.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "2cd626a5-098e-42cf-8f5c-876f7b0d987d", "name": "Success. The subscription plan is removed from the offering.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a3d83660-62aa-41d3-8074-5d463335a890", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fa8f930-1d95-4db7-9461-9542874a8e0a", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "68d97485-2c63-4c66-b96b-3324c56176f2", "name": "List the pricing options available to a plan in an offering", "request": { "name": "List the pricing options available to a plan in an offering", "description": {}, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "07865188-9774-4dbb-bba2-7444f6708998", "name": "Success. The pricing option relationships are returned", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b07954a2-87d5-4cab-8c7c-ea31994ff89e", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "572ab0d9-7125-4be1-b9cc-4b07f4bf52f8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a3b35fbf-3533-40fa-b2d1-d2e8a081eff3", "name": "Adds an offering's pricing options to the plan", "request": { "name": "Adds an offering's pricing options to the plan", "description": { "content": "Use the unique identifier of the pricing in the offering that you want to update. Any modifications that you make to the plans in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "80127131-810c-4ac7-ab73-0a6a4a8bc4f1", "name": "Success. The pricing options are added to the plan", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "346093f4-1807-4fe1-a979-1a5cb7d0228c", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "193278a5-039a-4e77-8f72-f0011010930b", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ed1e389-0704-4a58-bc2f-a125dc9535e4", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4c443bb-08b5-4240-b413-3ed6e14910a8", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41af933c-94b0-4f7f-b237-f78a0a726eb9", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0d990a2f-917c-4008-be2e-12293cd0e829", "name": "Removes an offering's pricing options from the plan", "request": { "name": "Removes an offering's pricing options from the plan", "description": { "content": "Use the unique identifier of the pricing in the offering that you want to update. Any modifications that you make to the plans in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6f01ddd4-de37-407d-b768-96fa983baa47", "name": "Success. The pricing options are added to the plan", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4e3ac6b-3745-443a-ae21-3bc117199680", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9afd3bc1-0742-4c98-a81f-02a0359b2dd4", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c9ab5bbf-be87-41c1-bd32-3b7afce8812c", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c21532fb-f2c0-4f8c-ad0b-43be6b9ffa09", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc28320a-5b6e-4d35-8ce9-75121464d37b", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "offerings", ":offering_uuid", "plans", ":plan_uuid", "relationships", "pricing_options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the offering.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "offering_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Subscriptions", "description": "Elastic Path Subscriptions enables you to manage your subscriptions plans and pricing options, using offerings. Offerings can contain any combination of pricing options and a plan. When a customer chooses a pricing option, a subscription is created. \n\n### Managing the Subscription Lifecycle\n\nThe subscription lifecycle is the states that a subscription can go through when a customer subscribes to a service or a plan. \n\nA subscription can have the following states:\n\n- `pending`\n- `canceled`\n- `paused`\n- `resumed`\n\n#### Creating a pending subscription \n\nA subscription can be created in a `pending` state. This is useful for several reasons.\n\n- If there are subscriptions that require user setup or onboarding, for example, installing software or setting up preferences. This helps reduce shopper frustration during the onboarding process, as the shopper is not paying for a service that they cannot use yet.\n- When offering a free trial or promotion, keeping the subscription in a pending state until the trial or promotion starts or ends allows you to manage transitions more smoothly. \n- Before a subscription becomes active, you may need to verify the payment method or authorize the first payment. Keeping the subscription in a pending state allows time to complete these steps without activating the subscription.\n\nFor a subscription with a `pending` state, you can also configure a `go_live_after` date. The subscription starts from the `go_live_after` date. This is useful as it ensures both the subscription provider and subscriber are clear about when a subscription officially begins. Once the `go_live_after` date is passed, the subscription becomes `active`, initiating the billing and payment runs. If a subscription is activated this way, you can see this in the `timestamp` meta. \n\nYou can configure a `go_live_after` date to be a past date. This is useful, for example, for backdating a subscription or managing a delay in activating a subscription. Setting the `go_live_after` date in the past ensures the subscriptions timeline correctly aligns with the agreed-upon service start date. \n\n:::caution\n\nAlthough, billing runs generate one invoice per subscription, if a `go_live_date` is set far in the past, multiple invoices could be generated over the course of several billing runs, which could be frustrating and confusing to your subscribers. \n\n:::\n\nSee [create a subscription](/docs/api/subscriptions/create-subscription).\n\n#### Cancelling or pausing and resuming subscriptions\n\nA subscriber can decide to cancel or pause and/or resume a subscription. The following example describes pausing or canceling and resuming a subscription.\n\n1. The subscriber pauses or cancels the subscription. \n - The subscription status is `active`. \n - either `paused` or `cancelled` is set to `true`.\n - either the `paused_at` or `cancelled_at` timestamp is populated with the date and time the subscription is paused or cancelled.\n - for cancelled subscriptions, `end_date` indicates when the subscription will expire and end.\n2. When the next billing run is due, the billing run checks the subscription state. If the subscription state is paused or cancelled then no invoice is created and the subscription status is updated to `inactive`.\n3. Subsequent billing runs skip that subscription completely as the subscription status is `inactive`.\n4. If the subscriber resumes the subscription:\n - either `paused` or `cancelled` is set to `false`.\n - the `resumed_at` timestamp is populated with the date and time the subscription is resumed.\n5. When the next billing run is due, the billing run checks the subscription state. If the `paused` or `cancelled` is set to `false` then the billing run creates an invoice.\n6. The payment run processes the invoice. Once the payment succeeds then the payment run updates the status of the subscription to `active`.\n\n### Orders\n\nWhen a customer chooses a subscription, they need to add the subscription to a cart, checkout the cart and then pay for the order. \n\n1. When a customer adds a subscription to cart, this is handled using the `Add subscription to cart` endpoint. \n2. Once a subscription has been added to a cart, the [**Checkout API**](/docs/api/carts/checkout-api) converts the cart to an order. \n3. Once the order is created, payment needs to be taken. This is handled by Elastic Path Payments Powered by Stripe. See [**Payments**](/docs/api/subscriptions/invoices#payments).\n", "item": [ { "id": "bd2145de-300c-4442-93fb-1a5da6a14f92", "name": "Create a subscription", "request": { "name": "Create a subscription", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"currency\": \"USD\",\n \"name\": \"Albert Einstein\",\n \"email\": \"albert@elasticpath.com\",\n \"manual_payments\": false,\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering_external_ref\": \"abc123\",\n \"offering_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"pending\": false,\n \"first_invoice_paid\": false,\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"override_first_period_end_date\": \"2027-02-01T00:00:00Z\",\n \"offering\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"features\": [\n \"abc123\"\n ],\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ],\n \"key_1\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"selected_plan\": \"abc123\",\n \"selected_pricing_option\": \"abc123\",\n \"order\": {\n \"order_id\": \"11111111-2222-3333-4444-555555555555\",\n \"order_item_id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f7dd2261-43ee-4184-9549-23fc1638f88d", "name": "Success. The subscription is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"currency\": \"USD\",\n \"name\": \"Albert Einstein\",\n \"email\": \"albert@elasticpath.com\",\n \"manual_payments\": false,\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering_external_ref\": \"abc123\",\n \"offering_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"pending\": false,\n \"first_invoice_paid\": false,\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"override_first_period_end_date\": \"2027-02-01T00:00:00Z\",\n \"offering\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"features\": [\n \"abc123\"\n ],\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ],\n \"key_1\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"selected_plan\": \"abc123\",\n \"selected_pricing_option\": \"abc123\",\n \"order\": {\n \"order_id\": \"11111111-2222-3333-4444-555555555555\",\n \"order_item_id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"currency\": \"USD\",\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"canceled_at\": \"2017-01-10T11:41:19.244842Z\",\n \"paused_at\": \"2017-01-10T11:41:19.244842Z\",\n \"resumed_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_date\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"status\": \"active\",\n \"canceled\": true,\n \"paused\": true,\n \"closed\": true,\n \"pending\": false,\n \"suspended\": false,\n \"invoice_after\": \"2017-01-10T11:41:19.244842Z\",\n \"manual_payments\": false,\n \"first_invoice_prepaid\": false,\n \"state\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"pending_price_change\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"price_update_history\": [\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_3\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "206f0c3f-23b6-4121-ab84-bdd07eef9a87", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"currency\": \"USD\",\n \"name\": \"Albert Einstein\",\n \"email\": \"albert@elasticpath.com\",\n \"manual_payments\": false,\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering_external_ref\": \"abc123\",\n \"offering_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"pending\": false,\n \"first_invoice_paid\": false,\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"override_first_period_end_date\": \"2027-02-01T00:00:00Z\",\n \"offering\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"features\": [\n \"abc123\"\n ],\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ],\n \"key_1\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"selected_plan\": \"abc123\",\n \"selected_pricing_option\": \"abc123\",\n \"order\": {\n \"order_id\": \"11111111-2222-3333-4444-555555555555\",\n \"order_item_id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "658d6522-c06d-4317-94b7-8420f4dfbfcf", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"currency\": \"USD\",\n \"name\": \"Albert Einstein\",\n \"email\": \"albert@elasticpath.com\",\n \"manual_payments\": false,\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering_external_ref\": \"abc123\",\n \"offering_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"pending\": false,\n \"first_invoice_paid\": false,\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"override_first_period_end_date\": \"2027-02-01T00:00:00Z\",\n \"offering\": {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"features\": [\n \"abc123\"\n ],\n \"plans\": [\n {\n \"name\": \"Magazine\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"pricing_options\": [\n {\n \"name\": \"Monthly\",\n \"billing_interval_type\": \"month\",\n \"billing_frequency\": 1,\n \"plan_length\": 12,\n \"end_behavior\": \"close\",\n \"can_pause\": false,\n \"can_resume\": false,\n \"can_cancel\": false,\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"meta\": {\n \"selected\": true\n }\n }\n ],\n \"configured_features\": {\n \"key_0\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n }\n },\n \"pricing_option_associations\": {\n \"key_0\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ],\n \"key_1\": [\n \"11111111-2222-3333-4444-555555555555\",\n \"11111111-2222-3333-4444-555555555555\"\n ]\n },\n \"selected_plan\": \"abc123\",\n \"selected_pricing_option\": \"abc123\",\n \"order\": {\n \"order_id\": \"11111111-2222-3333-4444-555555555555\",\n \"order_item_id\": \"11111111-2222-3333-4444-555555555555\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b49f9c5a-9d7b-4796-bcfd-3914afa5e67b", "name": "List subscriptions", "request": { "name": "List subscriptions", "description": { "content": "Retrieves a list of all subscriptions.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `account_id`, `name`, `email`, `external_ref` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `account_id`, `name`, `email`, `external_ref` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n\n### Including Resources\n\nYou can use the `include` parameter to include the following resources with this endpoint.\n\n| Resource | Required | Description |\n| --- | --- | --- |\n| `pricing_options, plans` | Optional | Retrieves all pricing options and plans associated with a subscription. |\n| `plans` | Optional | Retrieves all plans associated with a subscription. |\n| `pricing_options` | Optional | Retrieves all pricing options associated with a subscription. |\n\nSee [Characteristics of Include Parameter](/guides/Getting-Started/includes#characteristics-of-include-parameter).\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5a5a9583-0d12-4ff9-afa2-90aaaa88794c", "name": "Success. A list of subscriptions is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"currency\": \"USD\",\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"canceled_at\": \"2017-01-10T11:41:19.244842Z\",\n \"paused_at\": \"2017-01-10T11:41:19.244842Z\",\n \"resumed_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_date\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"status\": \"active\",\n \"canceled\": true,\n \"paused\": true,\n \"closed\": true,\n \"pending\": false,\n \"suspended\": false,\n \"invoice_after\": \"2017-01-10T11:41:19.244842Z\",\n \"manual_payments\": false,\n \"first_invoice_prepaid\": false,\n \"state\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"pending_price_change\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"price_update_history\": [\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"currency\": \"USD\",\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"canceled_at\": \"2017-01-10T11:41:19.244842Z\",\n \"paused_at\": \"2017-01-10T11:41:19.244842Z\",\n \"resumed_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_date\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"status\": \"active\",\n \"canceled\": true,\n \"paused\": true,\n \"closed\": true,\n \"pending\": false,\n \"suspended\": false,\n \"invoice_after\": \"2017-01-10T11:41:19.244842Z\",\n \"manual_payments\": false,\n \"first_invoice_prepaid\": false,\n \"state\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"pending_price_change\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"price_update_history\": [\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"included\": {\n \"plans\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_3\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n },\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cecce297-dcfb-4281-8dba-e43393e776a8", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53dfd7df-bf15-4317-a225-a95017798cb5", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "07cda4a5-6d16-439b-a6b2-fc898d38f420", "name": "Get subscription", "request": { "name": "Get subscription", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2a23808a-09d0-4e38-a4ca-42af1357f489", "name": "Success. The details of a subscription are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"currency\": \"USD\",\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"canceled_at\": \"2017-01-10T11:41:19.244842Z\",\n \"paused_at\": \"2017-01-10T11:41:19.244842Z\",\n \"resumed_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_date\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"status\": \"active\",\n \"canceled\": true,\n \"paused\": true,\n \"closed\": true,\n \"pending\": false,\n \"suspended\": false,\n \"invoice_after\": \"2017-01-10T11:41:19.244842Z\",\n \"manual_payments\": false,\n \"first_invoice_prepaid\": false,\n \"state\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"pending_price_change\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"price_update_history\": [\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"included\": {\n \"plans\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n },\n \"key_4\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"pricing_options\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6d9d0a3-94b1-425a-92d8-aa2fb5448bcd", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cccfb60e-9fdc-41a3-b278-fc0b3ab560dc", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "034fd21a-dd6a-42aa-991d-6c76ae7aaa5f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "include", "value": "plans,pricing_options" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "757ba43a-2fa9-456d-8ec6-0e9780c9677a", "name": "Update a subscription", "request": { "name": "Update a subscription", "description": { "content": "Updates a subscription. For example, a subscriber can switch from one pricing option to another in a subscription.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "bccacb41-540d-4d5a-82f4-7764b008fbed", "name": "Success. The subscription is updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"pricing_option_id\": \"11111111-2222-3333-4444-555555555555\",\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"offering\": {\n \"type\": \"subscription_offering\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"external_plan_refs\": [\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\",\n \"97dddc65-eabd-45d8-b45b-2ece5cfc8c50\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n \"currency\": \"USD\",\n \"external_ref\": \"abc123\",\n \"address_id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"canceled_at\": \"2017-01-10T11:41:19.244842Z\",\n \"paused_at\": \"2017-01-10T11:41:19.244842Z\",\n \"resumed_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_date\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\",\n \"go_live\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"status\": \"active\",\n \"canceled\": true,\n \"paused\": true,\n \"closed\": true,\n \"pending\": false,\n \"suspended\": false,\n \"invoice_after\": \"2017-01-10T11:41:19.244842Z\",\n \"manual_payments\": false,\n \"first_invoice_prepaid\": false,\n \"state\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"pending_price_change\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"price_update_history\": [\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"price_changes\": {\n \"plan_prices\": {\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"pricing_option_prices\": {\n \"83f6b8e3-031c-4f2a-a1d7-b1c83cb5ac3c\": {\n \"base_price_percentage\": 90\n },\n \"197a11f4-d341-4594-9574-7fbfbe6a671d\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"valid_until\": \"2017-01-10T11:41:19.244842Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_3\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db2adf25-d823-4844-be01-6d11ac02ebc4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f27e09b-8771-4bc9-93a7-85bca778907d", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e1d372f-4e98-48d3-81dc-7cbfc799290e", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b419dcd-c91f-4e1e-9adf-36d761531acd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription\",\n \"attributes\": {\n \"pricing_option_id\": \"00000000-0000-0000-0000-000000000001\",\n \"plan_id\": \"00000000-0000-0000-0000-000000000001\",\n \"address_id\": \"00000000-0000-0000-0000-000000000001\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n },\n \"go_live_after\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4e8ec65a-9b4a-45ed-bed3-9b3364632eab", "name": "Delete a subscription", "request": { "name": "Delete a subscription", "description": { "content": "Deletes a subscription\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "9179b76a-3ffd-4761-8a15-d7176915d45b", "name": "Success. The subscription is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "47fc3c94-1cbc-41ff-bfff-6157b40824ed", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b2853d6-f4b2-4ec9-b2d3-28bc414c40a9", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1eba18d6-cce5-47e0-a458-24213687a568", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "87b464cf-0ea7-45b5-910e-32d6bd3bc71f", "name": "Get a feature in a subscription", "request": { "name": "Get a feature in a subscription", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d9c24d07-a5e5-4f04-963a-150d6305f257", "name": "Success. The details of the feature are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04a1da53-f490-401e-b1a5-e47cc752ee47", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a5263db-2591-43a3-94c5-34c7ae1bfaac", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81b79194-8d05-4d18-9ea7-4e4ccee1234e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features", ":feature_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the feature.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "feature_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56ea2c60-ff66-469d-8455-c196900d53ab", "name": "Get a plan in a subscription", "request": { "name": "Get a plan in a subscription", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5274a066-381c-49a3-8eda-40703543555a", "name": "Success. The details of the plan are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60bf0513-05d4-4ef4-89fa-19dc2eb27831", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6950146e-7fcb-4ee3-b265-fcc120c08a2e", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbafb51d-3fd0-4b1b-9a04-0ca3d99d25f4", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans", ":plan_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the plan.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "plan_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3015e488-3c0a-4b8b-bda8-8cb301688277", "name": "Get a pricing option in a subscription", "request": { "name": "Get a pricing option in a subscription", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "efeb07b1-b250-4448-9d8b-e4f85b6062fb", "name": "Success. The details of the pricing option are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d674ed2-7b60-49fb-b8cc-d48857200953", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ceb67ca1-ad8f-4d4d-8f83-f5fa7bcb1103", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07507406-89bc-41d0-8eb6-4ceb90060b3a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options", ":pricing_option_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the pricing option.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "pricing_option_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a410c8fe-52bd-4a89-8d63-02f5ddb6c1ef", "name": "List an subscriptions features", "request": { "name": "List an subscriptions features", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cd53510b-e702-4021-843e-1e53596749c5", "name": "Success. A list of subscription features is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_feature\",\n \"attributes\": {\n \"name\": \"Digital library access\",\n \"configuration\": {\n \"type\": \"access\",\n \"tag\": \"digital_library_access\"\n },\n \"external_ref\": \"abc123\",\n \"description\": \"Access to over 100 ebooks via the digital library.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5368122e-50a1-4591-a7b1-efee9486ccd5", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2ef1154-d602-464d-aa5e-ecb2d5054958", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "features" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f94f6185-e475-4e19-9fec-2efcaf69a3cf", "name": "List subscription plans", "request": { "name": "List subscription plans", "description": { "content": "Retrieves a list of plans associated with the specified subscription. Using this endpoint you can see the plan that is currently active in a subscription. If `active_plan` is `true`, a plan is active in a subscription. If `active_plan` is null, the pricing option is not active.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5cfebb11-844d-429a-b45e-fa7a338b6d25", "name": "Success. A list of subscription plans is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_plan\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"feature_configurations\": {\n \"key_0\": {\n \"type\": \"access\"\n },\n \"key_1\": {\n \"type\": \"access\"\n },\n \"key_2\": {\n \"type\": \"access\"\n },\n \"key_3\": {\n \"type\": \"access\"\n }\n },\n \"name\": \"Magazine\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A lovely magazine that is published every month.\",\n \"sku\": \"MAGAZINE1\",\n \"main_image\": \"https://magazine.com/cover.jpg\",\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"price_units\": {\n \"unit\": \"day\",\n \"amount\": 7\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_plan\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff83ac5e-e168-47b0-85c3-3173ec1788e5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60a4c81f-bf2f-423c-9084-52faa0666256", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c34e50a-7d4d-4d11-afcf-68397903b68e", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e1d0c19-d505-4329-85cd-f01d8b0039bc", "name": "Manage subscription plans", "request": { "name": "Manage subscription plans", "description": { "content": "Manage subscription plans by replacing, changing or detaching plans on the subscription", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "437c16bb-cf6f-4479-8acf-7b819a6987a3", "name": "Success. The subscription's plans have been updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "dfda80b5-79c8-4f2f-acee-ab1d7ea5eabd", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "085c0a54-9245-4527-bf51-97a975963d3c", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2937af9b-f568-42a3-b604-9e99d59b3ac4", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37dbaf2e-5539-476a-bc2d-e56115b8e796", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": [\n {\n \"type\": \"attach\",\n \"plans\": [\n \"bafa601f-359c-48da-834e-377b6c0d9466\"\n ]\n },\n {\n \"type\": \"detach\",\n \"plans\": [\n \"a8aad94d-60fc-44f7-8dfa-299249566ec4\"\n ]\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "32ed9b65-2ec3-41f8-a2f8-56c3e36c4d08", "name": "List subscription pricing options", "request": { "name": "List subscription pricing options", "description": { "content": "Retrieves a list of pricing options associated with the specified subscription. Using this endpoint you can see the pricing options that are currently active in a subscription. If `active_pricing_option` is `true`, a pricing option is active in a subscription. If `active_pricing_option` is null, the pricing option is not active.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "19079a63-bf8d-4cb9-82cf-3cf7e1d827fa", "name": "Success. A list of subscription pricing options is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_1\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n },\n \"key_2\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_offering_pricing_option\",\n \"attributes\": {\n \"billing_frequency\": 1,\n \"billing_interval_type\": \"month\",\n \"can_cancel\": false,\n \"can_pause\": false,\n \"can_resume\": false,\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"end_behavior\": \"close\",\n \"name\": \"Monthly\",\n \"plan_length\": 12,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"description\": \"A monthly subscription.\",\n \"trial_period\": 7,\n \"lead_time\": {\n \"type\": \"day\",\n \"time\": 14\n },\n \"notification_schedule\": [\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n },\n {\n \"name\": \"Daily billing run.\",\n \"unit\": \"day\",\n \"amount\": 100\n }\n ],\n \"base_price_percentage\": 90,\n \"fixed_price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"prices\": {\n \"key_0\": {\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n }\n }\n },\n \"price\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"display_price\": {\n \"without_tax\": {\n \"amount\": 100,\n \"currency\": \"USD\",\n \"formatted\": \"$1.00\"\n },\n \"with_tax\": {\n \"amount\": 110,\n \"currency\": \"USD\",\n \"formatted\": \"$1.10\"\n }\n },\n \"active_pricing_option\": true\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8984a89-27d9-4cda-b684-595fe9c82b01", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba32977b-45e1-4bc9-8876-95da451c7179", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d73afe72-2d6c-4aed-bbae-b2d1877aaa46", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "pricing-options" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9f5b4136-1caa-49dd-86fc-413062f8b82a", "name": "Create a subscription state", "request": { "name": "Create a subscription state", "description": { "content": "The subscription lifecycle is the states that a subscription can go through when a customer subscribes to a service or a plan. \n\nA subscription can have the following states:\n\n- `pending` \n- `canceled`\n- `paused`\n- `resumed`\nFor more information, see [Managing the Subscription Lifecycle](/docs/api/subscriptions/subscriptions#managing-the-subscription-lifecycle).\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "9bdc978e-6070-4c34-a7d2-e47d62f66ce6", "name": "Success. The subscription's state has changed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "240644cc-a94c-4c92-9cac-0d215330ed77", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b006d09-f57d-4bcf-8262-2631e4ccf4d1", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4eccf75-1723-4438-a0e5-bec085e13058", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "951dafad-6be9-4192-81fe-f43ed5e8715a", "name": "List subscription states", "request": { "name": "List subscription states", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c4e7e8ab-e040-4589-bf17-c58f2fad1609", "name": "Success. A list of subscription states is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0d30933-1d8a-4881-b7fa-9eb7b6fb9a5a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee34c93a-2cd6-428b-ad98-007285f04807", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99c09f02-aa04-4ae2-8936-47e28e5f4017", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8e91073c-8079-4857-b5c4-b4cf684e3a68", "name": "Get subscription state", "request": { "name": "Get subscription state", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states", ":state_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "state_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription state.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "175b58c3-3d1b-4a75-8983-859c5914a4d0", "name": "Success. A subscription state is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states", ":state_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription state.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "state_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_state\",\n \"attributes\": {\n \"action\": \"cancel\"\n },\n \"meta\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db0dccab-019f-420a-a137-cad6853109fb", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states", ":state_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription state.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "state_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d9386077-13ab-46c9-af94-b8edb3c1e496", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states", ":state_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription state.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "state_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3ab70e8-785d-4058-bd87-7df4029be8d8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "states", ":state_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription state.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "state_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d075cd3-353f-4d92-b675-8d57848e26cd", "name": "List subscription invoices", "request": { "name": "List subscription invoices", "description": { "content": "Lists all invoices for a given subscription.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6824059f-ebf6-4dec-8819-189bad006d4d", "name": "Success. A list of invoices is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb3e4483-b70d-431a-b75a-91a7a5e91be8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "abf64057-3621-4623-9c7b-35c15b580a2d", "name": "List subscription invoice payments", "request": { "name": "List subscription invoice payments", "description": { "content": "Lists all invoice payments for a given invoice.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid", "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "160f5ec2-3405-4079-be43-5248f51ee92f", "name": "Success. Payments for the invoice are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid", "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e3f9df67-3b50-4ecc-b95b-a9da0f6662ed", "name": "Get subscription invoice payment", "request": { "name": "Get subscription invoice payment", "description": { "content": "Gets a specific payment for a given invoice.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "50953515-a475-492a-92a7-566ff3f80955", "name": "Success. Specific payment for the invoice is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "837209d9-1010-4a05-b354-0d8f6a5f334d", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2d20489f-1959-4229-8d7e-19b9b2db6a9f", "name": "Get subscription invoice", "request": { "name": "Get subscription invoice", "description": { "content": "Gets a specific invoice for a given subscription.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "40664703-2f1e-4b9c-921c-a700c7a1b6ca", "name": "Success. An invoice is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46f21f41-0cfa-4b54-87b2-08e49f2c00ad", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fe9908e-e563-431b-b82a-57136dbd9acf", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscriptions", ":subscription_uuid", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscription.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscription_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Jobs", "description": "Jobs are an asynchronous process that can be triggered manually or scheduled. \n\nThere are three types of job:\n\n- a billing run. Subscriptions generates an [**invoice**](/docs/api/subscriptions/invoices) when a billing run occurs. Billing runs generate invoices for the remaining billing cycles for each subscription. The invoice dates come from your pricing options. Billing runs are independent of payment runs.\n- a tax run. Invoices where `tax_required` is `true` will not have payment taken until a tax run has added the required tax to the invoice.\n- a payment run. The payment run identifies invoices that are outstanding and attempts to take payment for them. If the payment succeeds the the invoice is no longer outstanding. If the payment fails for any reason, then the invoice remains outstanding and is picked up by the next payment run to retry the payment.\n\nBy scheduling billing and payment runs, you automate the process, reducing manual intervention and ensuring the jobs are run in a timely manner. See [**Schedules**](/docs/api/subscriptions/schedules).\n\n### Characteristics of Billing, Tax & Payments Jobs\n\nBilling and payment jobs have the following characteristics.\n\n- Jobs are asynchronous.\n- Jobs have a different status, depending on where a job is in its lifecycle.\n- Jobs report any errors to help you understand the reason for any failed jobs.\n- Only one billing run and payment run is allowed per store at a time. Although billing and payments are constantly generated, the jobs are queued. Subscriptions looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed.\n\n### Billing, Tax & Payments Jobs Lifecycle\n\nA job can have the following status types:\n\n- PENDING - Subscriptions has received the request but is currently busy processing other requests.\n- STARTED - Subscriptions has started processing the job.\n- SUCCESS - The job has successfully completed.\n- FAILED - The job has failed.\n\n### Billing, Tax & Payment Reports\n\nYou can track your Subscriptions billing, payment and tax operations using reports. There are three types of report:\n\n- `BillingRunReport` - This report provides invoice summaries such as invoices ready for payment, invoices that require tax, and invoice failures.\n- `TaxRunReport` - This report provides invoice summaries such as invoices to which tax was successfully or unsuccessfully added.\n- `PaymentRunReport` - This report provides invoice summaries such as invoices for which payment was attempted, failed payment attempts and totals collected by a payment run. \n- `NotificationRunReport` - This report provides notification summaries such as notifications sent and failed to send.\n- `SubscriptionUpdateReport` - This report provides subscription update summaries such as subscriptions that were updated successfully and failed updates.\n\nSee [Get a job](/docs/api/subscriptions/get-job) and [List jobs](/docs/api/subscriptions/list-jobs).\n", "item": [ { "id": "cfe14f1c-065a-4eef-8a35-111b553a6ad3", "name": "Create a job", "request": { "name": "Create a job", "description": {}, "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"job_type\": \"billing-run\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "2c685b94-9708-4350-af7d-45b99541006c", "name": "Success. The job was created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"job_type\": \"billing-run\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job_type\": \"billing-run\",\n \"status\": \"pending\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"report\": {\n \"invoices_ready_for_payment\": 100,\n \"invoices_tax_required\": 100,\n \"invoice_failures\": 0,\n \"total_ready_for_payment\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"total_tax_required\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33aded13-7bf0-44ae-9cb3-dcb2344c5aca", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"job_type\": \"billing-run\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eed089cc-e1b6-46be-abc2-ce111a0416f0", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"job_type\": \"billing-run\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9dcf4fb7-d1f3-42fb-8ea7-2dbc0d41e938", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"job_type\": \"billing-run\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2e867a34-18d7-4ab0-8abd-5891bbc69b54", "name": "List jobs", "request": { "name": "List jobs", "description": { "content": "Retrieves a list of all jobs.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `external_ref` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `external_ref` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "61442845-6780-4278-859d-6813944a70e5", "name": "Success. A list of jobs is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job_type\": \"billing-run\",\n \"status\": \"pending\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"report\": {\n \"invoices_ready_for_payment\": 100,\n \"invoices_tax_required\": 100,\n \"invoice_failures\": 0,\n \"total_ready_for_payment\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"total_tax_required\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job_type\": \"billing-run\",\n \"status\": \"pending\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"report\": {\n \"invoices_ready_for_payment\": 100,\n \"invoices_tax_required\": 100,\n \"invoice_failures\": 0,\n \"total_ready_for_payment\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"total_tax_required\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\",\n \"key_2\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7a42e04-3e5a-4fb6-bb77-c5140ba4e878", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "07fef3c1-322e-47fd-b2e9-df8327dfb246", "name": "Get job", "request": { "name": "Get job", "description": {}, "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "cd02d107-6a5a-49f5-bff7-244bc145cd51", "name": "Success. The job is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_job\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job_type\": \"billing-run\",\n \"status\": \"pending\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"report\": {\n \"invoices_ready_for_payment\": 100,\n \"invoices_tax_required\": 100,\n \"invoice_failures\": 0,\n \"total_ready_for_payment\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n },\n \"total_tax_required\": {\n \"USD\": {\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"GBP\": {\n \"amount\": 90,\n \"includes_tax\": true\n }\n }\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "645f9e4a-47ff-4d86-9553-e7d4c6a9d935", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9dca58ea-0084-45ec-8b01-fb63fa58764d", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dce7a58a-f761-4b7c-a027-c3b4880a4346", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0fe85d7f-8159-4fd5-af16-c117f2d14799", "name": "Delete job", "request": { "name": "Delete job", "description": {}, "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "68c4d5c0-f787-4ea3-9733-f66e693fde8f", "name": "Success. The job was deleted.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a91fb25d-3047-4def-80ba-d17a1c7a7a0a", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "jobs", ":job_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the job.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "job_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Imports", "description": "You can import subscription features, subscribers, offerings and subscriptions using Subscriptions Import. This is useful if you want to import subscriptions from an external system into Elastic Path Subscriptions. \n\nThe API uses a [**JSONL**](https://jsonlines.org/) file. Here is an [**example of a JSONL file**](/assets/subscriptions_import.jsonl).\n\nWhen you send an import request, an import job is created. Jobs are processed one at a time. You can continue to send import requests, but those jobs are queued. In other words, Subscriptions looks for any jobs that have a status of PENDING and starts the job with the earliest created date. This process is repeated until all jobs are processed. Use [List import jobs](/docs/api/subscriptions/list-import-jobs) to see a list of all import jobs.\n\nA file can include up to 50,000 objects. If you have more than 50,000 objects, then you must create a separate file, and import each file, one at a time.\n\n### Characteristics of Subscriptions Import\n\nThe Subscriptions Import API has the following characteristics:\n\n- The Subscriptions Import API reads the entire file and then creates the subscription objects. This means the subscription objects can be in any order in the file.\n\n- Subscriptions imports are asynchronous and are processed one at a time. You can continue to send import requests, but these are queued. \n\n- The API works on a \"best endeavours\" approach. In other words, the API does its best to create the subscription objects based on the file that you provide. \n\n### Subscriptions Import File\n\nThe following table describes the subscriptions objects, and their attributes, that the import file can include.\n\n| Object | Attributes |\n| --- | --- |\n| A subscriber object | The attributes you specify for a subscriber object are the attributes you specify when [creating a subscriber](/docs/api/subscriptions/create-subscriber). |\n| An offering object | The attributes you specify for an offering object are the attributes you specify when [building an offering](/docs/api/subscriptions/build-offering). |\n", "item": [ { "id": "f074eb64-e2ce-49b1-9923-83bb8eea2f11", "name": "Import a dataset", "request": { "name": "Import a dataset", "description": {}, "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] }, "auth": null }, "response": [ { "id": "59d33f43-d9ae-4dcd-acb3-fa878fb3d37c", "name": "Success. The import was started.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_import\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 50000,\n \"subscription_offering\": 50000,\n \"subscription\": 50000\n },\n \"imported\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 45090,\n \"subscription_offering\": 45090,\n \"subscription\": 45090\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24ff1d99-9aba-4435-814e-7cfa0e994a2a", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5988c01-2743-4ba0-8150-116b3551ce44", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4d470f7-90b4-430a-a33d-c5483e119490", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) The JSONL file you want to upload.", "type": "text/plain" }, "key": "import_file", "type": "file" }, { "description": { "content": "A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.", "type": "text/plain" }, "key": "external_ref", "value": "abc123", "type": "text" } ] } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c46e3a4a-749f-4e44-b3f8-776da118cbf8", "name": "List import jobs", "request": { "name": "List import jobs", "description": { "content": "Retrieves a list of all import jobs.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6e039bcf-a3c9-4070-acad-b214b272d25b", "name": "Success. A list of import jobs is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_import\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 50000,\n \"subscription_offering\": 50000,\n \"subscription\": 50000\n },\n \"imported\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 45090,\n \"subscription_offering\": 45090,\n \"subscription\": 45090\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_import\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 50000,\n \"subscription_offering\": 50000,\n \"subscription\": 50000\n },\n \"imported\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 45090,\n \"subscription_offering\": 45090,\n \"subscription\": 45090\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1aca5b9e-3807-46f6-9031-833c473dbb64", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "66f11fea-4b8a-4097-8058-6b916c340fc0", "name": "Get import", "request": { "name": "Get import", "description": { "content": "Retrieves the import job for the specified ID.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "536e48c6-5559-434d-814a-9e3b38b5c62f", "name": "Success. The import is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_import\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"started_at\": \"2017-01-10T11:41:19.244842Z\",\n \"finished_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"records\": {\n \"uploaded\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 50000,\n \"subscription_offering\": 50000,\n \"subscription\": 50000\n },\n \"imported\": {\n \"subscription_feature\": 50000,\n \"subscription_subscriber\": 45090,\n \"subscription_offering\": 45090,\n \"subscription\": 45090\n }\n }\n },\n \"attributes\": {\n \"status\": \"pending\",\n \"external_ref\": \"abc123\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cd2ab99-92b6-4dd6-b16f-8676d7e2f441", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5da76566-84ef-479e-bb3b-1e9fdab845c2", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1b4c3f7-a878-4c77-a1e4-0ea364645683", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c1e883fc-a263-407a-b7e1-68e29a397046", "name": "Get import errors", "request": { "name": "Get import errors", "description": { "content": "Retrieves all errors encountered as part of the import. Each error is attributed to a line in the JSONL file \nimported, so for example, if at line 1 in your JSONL you had a subscription_offering without a name, there would\nbe a minimum string error for the `name` attribute with `\"line_number\": 1`.\n\nErrors are also ordered by line number ascending, and can be paginated.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "666fb3f3-86d1-462b-834f-0d960d210d9d", "name": "Success. The import errors are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_import_error\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"error\": \"offering name cannot be empty\",\n \"field\": \"name\",\n \"line_number\": 123,\n \"external_ref\": \"abc123\"\n }\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_import_error\",\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"error\": \"offering name cannot be empty\",\n \"field\": \"name\",\n \"line_number\": 123,\n \"external_ref\": \"abc123\"\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6bd81fe4-92c8-4725-8b4c-5a644235d6d4", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "470d7e94-3ade-4a85-8527-2288f7d084ae", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "imports", ":import_uuid", "errors" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the import.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "import_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Schedules", "description": "You can schedule your billing, tax, and payment runs. By scheduling billing, tax, and payment runs, you automate the process, reducing manual intervention and ensuring the jobs are run in a timely manner. You can define a schedule in the format (`* * * * *`) which is a set of five fields in a line, indicating when a job should be executed. For example, you can define a schedule so that your job runs multiple times a day, or runs on specific days and months.\n\nSubscriptions runs on Coordinated Universal Time (UTC) time and conforms to [**RFC 3339**](https://www.rfc-editor.org/rfc/rfc3339). \n\n### Unrestricted fields\n\nSetting a field to an asterisk (`*`) is sometimes referred to as leaving a field unrestricted because it is not restricted to a specific value.\n\nYou can use the asterisk (`*`) to indicate the range of all values for the field. When you use the asterisk, the first value in the range is: 0 for the minute, hour, and day of the week (Sunday) fields, and 1 for day of the month and the month fields.\n\n### Configuring fields\n\nThe time fields have the following format and possible values and must be specified in the following order:\n\n| Field | Format | Description | \n| --- | --- | -----|\n| Minute | 0-59 | Indicates how far past the top of the hour your job runs, in minutes. For example if a minute is set to 0, then the job runs at the top of the hour because it is 0 minutes after the hour. This means if the hour is 8.00 AM, the job runs at 8.00 AM. |\n| Hour | 0-23 | Indicates how far past midnight your job runs, in hours. This is rounded down to the nearest hours. This is because minutes are indicated by the minute field. |\n| Day of the month | 0-31 | Indicates the calendar date of the month. For example, 1 for the first day of the month. |\n| Month | 1-12 or JAN to DEC | Indicates the month. Specify the month number or the first three letters of the month name in uppercase. For example, 1 or JAN for January. |\n| Day of the week | 0-6 (or SUN to SAT, or 7 for Sunday) | Indicates the day of the week. Monday is 1, Tuesday is 2, and so on. Either 0 or 7 indicates Sunday. Alternatively, specify the day of the week using the first three letters of the weekday name in uppercase. For example SUN for Sunday. If you use this field with the day of the month field, then this field is evaluated as an inclusive OR. For example, if the day of the month is set to 1 and the day of the week is set to SAT, the job runs on the first day of the month and on every Saturday of the month, even if the first day of the month is not a Saturday. If the day of the week is marked by an asterisk (*) then the field is marked as unrestricted. This means the job only runs on the first day of the month. |\n\n### Matching all values\n\nTo match all values for a field, set the field to an asterisk (`*`). When a field is set to an asterisk, the field matches all valid values for that field whenever the other field conditions are satisfied. \n\n Here are some examples.\n\n - `* 0 1 1 1`: the job runs every minute of the midnight hour on January 1st and Mondays.\n - `* * * * *`: the job runs every minute (of every hour, of every day of the month, of every month, every day of the week, because each of these is unrestricted).\n\n ### Matching a range\n\n To match a range of values, specify your start and stop values, separated by a hyphen (`-`). Do not include spaces in the range. Ranges are inclusive. The first number must be less than the second number. If you are using abbreviated names for the month or weekday (for example, JAN instead of 1 for the first month of the year), the first value must come earlier in the month or week than the second value.\n\nThe following equivalent examples run at midnight on Mondays, Tuesdays, Wednesdays, Thursdays, and Fridays (for all months):\n\n - `0 0 * * 1-5`\n - `0 0 * * MON-FRI`\n\n### Matching a list\n\nLists can contain any valid value for the field, including ranges. Specify your values, separated by a comma (,). Do not include spaces in the list.\n\nExamples:\n\n- `0 0,12 * * *`: the job runs at midnight and noon.\n- `0-5,30-35 * * * *`: the job runs in each of the first five minutes of every half hour (at the top of the hour and at half past the hour).\n\n### Skipping values in a range\n\nYou can skip values in a range by specifying a rate at which to step through the range. To do this, specify the range, followed by the forward slash (`/`) and the rate at which you want to skip through the range.\n\nThe step value cannot be larger than the largest possible value for the field. The default step is 1, so the step function `/1` is the same as not using a step function at all.\n\nExample ranges that use step functions:\n\n- `*/2`: this is a valid step function for any field. \n - For the minute field, it matches 0, 2, 4, ... , 58. \n - For the hour, it matches 0, 2, 4, ... , 22. \n - For the day of the month, it matches 1, 3, 5, ... , 31 (for a month with 31 days). \n - For the month, it matches 1, 3, 5, ... , 11. \n - For the day of the week, it matches 0, 2, 4, 6.\n\n- `0-12/2`: this is a valid step function for the minute and hour fields. It matches 0, 2, 4, ... , 12.\n\nExample schedules using step functions:\n\n- `*/2 * * * *`: the job runs every two minutes.\n- `0 0-12/2 * * *`: the job runs every two hours, on the hour. The first run is at midnight. The last run is at noon.\n", "item": [ { "id": "f8d8d500-45a2-4e5f-bbae-65ebe3f3c6ac", "name": "List schedules", "request": { "name": "List schedules", "description": { "content": "Retrieves a list of all schedules.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `external_ref` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `external_ref` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a7d53fa6-abe7-475d-8524-1defcd8811a7", "name": "Success. A list of schedules is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"location\": \"Europe/London\",\n \"specification\": \"30 0 * * *\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"scheduled_for\": \"2017-07-21T17:32:28Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"location\": \"Europe/London\",\n \"specification\": \"30 0 * * *\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"scheduled_for\": \"2017-07-21T17:32:28Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2827c33d-b2ef-4d71-ac7b-00d46f11bda4", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "007ef096-3d3b-4438-b6ed-23159ac8ada0", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a8047ae2-ad83-45ca-9ae3-4a75dc389cd6", "name": "Create a schedule", "request": { "name": "Create a schedule", "description": {}, "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "bd538ab0-0b42-4089-b98e-72645f78b86c", "name": "Success. The schedule is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"location\": \"Europe/London\",\n \"specification\": \"30 0 * * *\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"scheduled_for\": \"2017-07-21T17:32:28Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "284a2c3b-6597-445c-824a-f05eb41a1590", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e51dd6cb-e47a-488a-aff2-9acc0531e9a2", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f6dd90fb-6e5a-4964-8343-620ec04c74b9", "name": "Get a schedule", "request": { "name": "Get a schedule", "description": {}, "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "b3f54820-bc1f-49bc-8007-e1cb2a8e40c7", "name": "Success. A schedule is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"location\": \"Europe/London\",\n \"specification\": \"30 0 * * *\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"scheduled_for\": \"2017-07-21T17:32:28Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "492f8023-7776-4b90-855e-f27d4daf6782", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "101140da-07b1-46ae-bdb6-d58a1deb2151", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "70d70fdf-e70e-4140-b056-24e1ac02da4f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f62ceec6-be38-4796-92a9-cc5530b090cd", "name": "Update a schedule", "request": { "name": "Update a schedule", "description": {}, "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "0bf7ece4-dd15-4235-952c-22e24cfec587", "name": "Success. The schedule details are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"job\": {\n \"job_type\": \"billing-run\"\n },\n \"location\": \"Europe/London\",\n \"specification\": \"30 0 * * *\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"scheduled_for\": \"2017-07-21T17:32:28Z\"\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4ccce16-9051-4804-8520-1f8924550d73", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ca0c6ac-4f96-4d92-bbf3-b02cf94f2775", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d7eac86-eeeb-401c-9072-acd09bfb5bb8", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3fa5cbc-df1b-4e00-ab33-b298d1ed9003", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b08e7a90-c1fb-47c7-b5ed-f473a6d900ba", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_schedule\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Daily billing run.\",\n \"specification\": \"30 0 * * *\",\n \"location\": \"Europe/London\",\n \"job\": {\n \"job_type\": \"billing-run\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "29a1e53e-25e1-4395-a315-6207700a3900", "name": "Delete schedule", "request": { "name": "Delete schedule", "description": {}, "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "0b2c13bd-0c91-4d94-9c81-bcdd67b8e3b4", "name": "Success. The schedule is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "efaef48d-5b1e-4f77-98b3-dd84ef93680f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3413689-d7c8-4409-a6f6-03dcaf6dc8f8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "schedules", ":schedule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the schedule.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "schedule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Subscribers", "description": "A subscriber is someone who subscribes to your plan or service.\n", "item": [ { "id": "ef5b5e7b-e7aa-4a39-9b1a-d1cd20404164", "name": "List subscribers", "request": { "name": "List subscribers", "description": { "content": "Retrieves a list of all subscribers.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator | Attribute | Description |\n| --- | --- | --- | \n| `eq` | `account_id`, `name`, `email`, `external_ref` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `account_id`, `name`, `email`, `external_ref` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "7ef4663b-345d-4e32-8b1b-69c2e9ec14f5", "name": "Success. A list of subscribers is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"email\": \"john.doe@example.com\",\n \"name\": \"John Doe\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"feature_entitlements\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"email\": \"john.doe@example.com\",\n \"name\": \"John Doe\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"feature_entitlements\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "89386f93-82de-4447-83ae-1ce75e5138dc", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffafaa4d-bcab-4402-a24b-2ceba5f0c3dd", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0b1e4a97-14d1-4525-941f-3c6d729fcf28", "name": "Create a subscriber", "request": { "name": "Create a subscriber", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "7a7f1c89-2938-4272-9bdf-41c1a7a870da", "name": "Success. The subscriber is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"email\": \"john.doe@example.com\",\n \"name\": \"John Doe\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"feature_entitlements\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f18f6cb6-35fc-47fd-990a-c6b6fc678c02", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "875ffc8d-f12b-4365-802b-c3f84c09ab0f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "711daca3-e0c8-45a8-98bc-7eb27a13ccce", "name": "Get a subscriber", "request": { "name": "Get a subscriber", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "eb8c731b-e6dd-4bd0-9c54-75d611d6e9ae", "name": "Success. A subscriber is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"email\": \"john.doe@example.com\",\n \"name\": \"John Doe\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"feature_entitlements\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "926c3206-5128-4d1e-b3b1-eaa1a79a5690", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abaa2f67-6a56-4b4c-8ebe-80e1bf1494ca", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c48e0a0-4865-4f3d-be0c-f2b27f32082c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e740c808-c16a-476d-92e7-3018b2622923", "name": "Update a subscriber", "request": { "name": "Update a subscriber", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "f463bfae-f3ca-4b63-ae02-ecd9c2efff9a", "name": "Success. The subscriber details are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"account_id\": \"11111111-2222-3333-4444-555555555555\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"email\": \"john.doe@example.com\",\n \"name\": \"John Doe\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"feature_entitlements\": [\n \"tag1\",\n \"tag2\"\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faa47a93-9140-4929-b91c-fc9571f75399", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d5972b08-4cd0-4452-b637-d19a5850aed9", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a109212-f07e-4dda-9a26-76a33e54de09", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96c0f4fa-6ec4-4fd6-a301-9bea7928fec3", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "944ca374-9d85-49da-9df3-90a6bbd9136c", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_subscriber\",\n \"attributes\": {\n \"name\": \"John Doe\",\n \"email\": \"john.doe@example.com\",\n \"payment_authority\": {\n \"type\": \"elastic_path_payments_stripe\",\n \"customer_id\": \"cus_OPfKlxWV3hp9h6\",\n \"card_id\": \"card_8Diw3FQPhxK27WADPVMeXieP\"\n }\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "165ecff2-f68a-4355-beb1-9b8337d7c6ce", "name": "Delete subscriber", "request": { "name": "Delete subscriber", "description": {}, "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "3a4fae30-16e6-4308-a42c-6c74bda12209", "name": "Success. The subscriber is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4cd88137-f96e-49d8-88a0-09ba45d83113", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2651d7b4-9d7d-4f5c-871c-9e6712183562", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "subscribers", ":subscriber_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the subscriber.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "subscriber_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Invoices", "description": "Invoices represent the amount a customer owes for a subscription. Elastic Path Subscriptions generates an invoice for every period in a subscription billing cycle. Invoices provide:\n\n- an itemized list of goods and services provided by a subscription.\n- the cost of a subscription.\n- if applicable, any taxes.\n\nThe invoice lifecycle is described below.\n\n1. When a subscription is created, an invoice for the first billing period is created. When a subscription is created as part of an order, the payment for the order covers the first billing period.\n2. Subscription invoices are created by [**billing runs**](/docs/api/subscriptions/jobs). The billing run identifies subscriptions that require a new invoice for their next billing period and creates them. At this point, invoices are marked as outstanding.\n3. Invoices where `tax_required` is `true` will not have payment taken until a tax run has added the required tax to the invoice. \n3. The [**payment run**](/docs/api/subscriptions/jobs) identifies invoices that are still outstanding and attempts to take payment for them. If the payment succeeds the the invoice is no longer outstanding. If the payment fails for any reason, then the invoice remains outstanding and is picked up by the next payment run to retry the payment. If an invoice has a failed payment, payment is only retried if the fixed interval has passed from the last payment attempt as defined in Settings.\n\n### Payment Retries\n\nIt is important to limit the number of times Subscriptions retries a failed payment request for many reasons, including: frequent payment retries can indicate fraudulent activities; multiple failed payment attempts can lead to customers accounts being locked out or flagged for suspicious activity resulting in poor customer experience; and excessive retries places an unnecessary load on your payment processing system.\n\nIn Subscriptions, by default, the number of payment retries is 10. You can set this to a limit between 0 - 20, depending on your requirements. Each payment retry is made as a payment run. \n\nOnce the number of payment retries reaches the limit, the payment retries stop, resulting in status of the invoice being unpaid. See [Invoices](#invoices).\n\nWhen configuring payment retries, you have the following options.\n\n| Attribute | Required | Description |\n| --- | --- | --- |\n| `payment_retry_type` | Optional | One of the following options:
  • `fixed` - use `fixed` if you want a fixed time interval between payment retries.
  • `backoff` - use `backoff` if you want the time between retry attempts to increase exponentially.
  • `tiered` - use `tiered` if you want to specify a list of time durations.
|\n| `payment_retry_interval` | Optional | Represents the retry interval. For example, if `payment_retry_unit` is `week` and `payment_retry_interval` is `1` then, the payment retry interval is 1 week. |\n| `payment_retry_multiplier` | Optional | Use when `payment_retry_type` is `tiered` and represents the factor by which the time duration increases after each retry. |\n| `payment_retry_unit` | Optional | Represents the unit of time, either `day` or `week`. |\n\n### Rounding\n\nSubscriptions always rounds down to the penny. \n\n### Tax\n\nSubscriptions allows you to apply any number of tax rates to your invoices and subscriptions. When applying a tax rate, you must specify:\n\n- a name that appears on your customer's invoice that describes the specific type of tax.\n- the tax rate which is the percentage of the subscription amount that is required to be paid as tax.\n\nIn addition, you can optionally specify the jurisdiction which is the geographic area or political entity that has authority to levey and collect taxes.\n\nYou can apply more than one tax rate for all items in an invoice. You cannot apply a tax rate per line item.\n\n### Payments\n\nWhen your customers add a subscription to a cart and the cart is checked out, an unpaid order is returned. You can process the payment for the order though a payment gateway. You can do this using:\n\n- Elastic Path Payments Powered by Stripe. The Elastic Path Payments Powered by Stripe gateway interacts with Stripe to allow your subscribers to pay for their subscriptions. \n- Authorize.Net. \n\n#### Using Elastic Path Payments Powered by Stripe\n\nTo use Elastic Path Payments Powered by Stripe gateway, contact the [**Customer Success Team**](mailto:customersuccess@elasticpath.com). \n\nCreate your Stripe account in [**Stripe Dashboard**](https://dashboard.stripe.com/login) and complete an onboarding form to make payments using the gateway. For more information, see [**Onboarding**](/docs/payments/onboarding).\n\nOnce you have signed up for Elastic Path Payments Powered by Stripe, you must configure the payment gateway so that your shoppers can make payments. See [**Configure Elastic Path Payments Powered by Stripe**](/docs/payments/onboarding).\n\n#### Using Authorize.Net\n\nTo use Authorize.Net, you must have: \n\n- an active merchant account with Authorize.Net\n- obtained API credentials. These include an **API Login ID** and a **Transaction Key**.\n- Enabled Authorize.Net in Commerce Manager. See [Enabling Authorize.net](/docs/commerce-manager/payments/configure-other-payment-gateways#enabling-authorizenet).\n\n#### Payment Requests\n\nSubscriptions only supports the `purchase` payment mechanism. The gateway attempts to charge the customer immediately, and the result of the attempt is returned. If a payment fails, the invoice is kept as outstanding and the payment information, with the reason for the failure is attached to the invoice. A new payment run is required to attempt another payment. \n\nWhen sending a payment request to the Payments service, you must specify the following.\n\n| Attribute | Required | Description |\n| --- | --- | --- |\n| `gateway` | Required| One of `elastic_path_payments_stripe`, `authorize_net` and `stripe_payment_intents`. |\n| `method` | Required | Must be `purchase`.\n| `payment` | Required | The type of payment, for example, `pm_card_visa_debit`.\n| `options` | Required | These options must be set as they set up the card to be used in future without the customer being present. If these options are not set, future payments may fail. There are two options.
  • `off_session`. Must be set to `true`.
  • `confirm`. Must be set to `true`.
|\n\n#### External Payments\n\nExternal payments are payment methods not offered by Elastic Path Subscriptions (such as Elastic Path Payments powered by Stripe or Authorize.net), but they can still be integrated with Subscriptions. To do this, you must configure your subscriptions to use external payments by setting `manual_payments` to `true`. See [Create a Subscription](/docs/api/subscriptions/create-subscription).\n\nWhen a subscription is created with `manual_payments` set to `true`:\n\n1. When the payment run processes the generated invoice, it creates a pending payment. A `subscription-invoice-created` event is emitted that includes the `subscription_id`, `invoice_id` and `payment_id`. No payment is taken. \n2. You can use the events generated by Elastic Path Subscriptions to configure your external payment system to respond to these events, ensuring that your external payment system knows when the payment schedule has run and it's time to process the payment.\n3. When the external payment system handles the payment (either takes the payment successfully or the payment fails) the [Update Invoice Payment](/docs/api/subscriptions/update-invoice-payment) endpoint, enables the update of the pending payment. \n - If payment is successful, the invoice is updated to `paid` and the billing/payment cycle continues as normal.\n - If payment fails, the invoice continues to be marked as `outstanding`. The payment is not `pending` anymore. This is because a payment attempt has been made. Following on from this, the next payment run generates another manual pending payment. The external system is notified of this using the `subscription-invoice-payment-updated`.\n\n#### Card Declines\n\nCard payments can fail for a variety of reasons, including insufficient funds, incorrect card data or fraudulent activity. You can use the `card_id` and `customer_id` attributes to program your front-end implementation to allow your preferred payment service provider to update a subscription with new card details, enabling you to easily manage your subscription changes.\n", "item": [ { "id": "a6c26cf2-334d-4215-a17e-0f5d930ab028", "name": "List invoices", "request": { "name": "List invoices", "description": { "content": "Retrieves a list of all invoices.\n\n### Filtering\n\nThis endpoint supports filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering).\n\nThe following attributes and operators are supported.\n\n| Operator |Attribute | Description |\n| --- | --- | --- | \n| `eq` | `subscriber_id`, `subscription_id`, `outstanding`, `tax_required` | Equals. Checks if the values of two operands are equal. If they are, the condition is true. |\n| `in` | `subscriber_id`, `subscription_id` | In. Checks if the value is in the specified list. If it is, the condition is true. |\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ff9e7f96-b6f6-4182-bedb-244f6fceeffa", "name": "Success. A list of invoices is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbe9cac6-e772-45d1-985b-f719a57ce902", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6301f2d1-30a9-46db-8024-46af34d772c1", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8601d037-9d76-4953-ad3a-1bb430be2a9a", "name": "Get invoice", "request": { "name": "Get invoice", "description": {}, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d549ab8b-0b4e-4f2d-92b6-4d3159475767", "name": "Success. The details of the invoice are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_invoice\",\n \"attributes\": {\n \"billing_period\": {\n \"start\": \"2017-07-21T17:32:28Z\",\n \"end\": \"2017-07-21T17:32:28Z\"\n },\n \"pro_forma\": false,\n \"invoice_items\": [\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"description\": \"Magazine issue\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"plan_id\": \"11111111-2222-3333-4444-555555555555\",\n \"from_time_period\": \"2017-01-10T11:41:19.244842Z\",\n \"until_time_period\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"outstanding\": true,\n \"tax_required\": true,\n \"payment_retries_limit_reached\": false,\n \"manual_payment_pending\": true,\n \"tax_items\": [\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n },\n {\n \"type\": \"tax_item\",\n \"rate\": 0.2,\n \"name\": \"GST\",\n \"code\": \"20.0 % S\",\n \"jurisdiction\": \"USA\"\n }\n ],\n \"number\": 1,\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"valid_from\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"taxes_added_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"proration_events\": [\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n {\n \"proration_policy_id\": \"11111111-2222-3333-4444-555555555555\",\n \"billing_cost_before_proration\": 100,\n \"refunded_amount_for_unused_pricing_option\": 100,\n \"new_pricing_option_cost\": 100,\n \"prorated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n ],\n \"pro_rata_remaining_value\": 500,\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscriber_id\": \"11111111-2222-3333-4444-555555555555\",\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"notifications\": [\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n },\n {\n \"name\": \"7 days before renewal\",\n \"due\": \"2024-01-24T00:00:00Z\",\n \"sent_at\": \"2024-01-24T00:00:00Z\"\n }\n ]\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cebcef07-dcfa-4775-9f36-2ac7fc9ccc59", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34e4a9fe-fc05-44a2-a3f9-35f63e8fdf34", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "156916bb-7157-4037-890b-9c67dbea6947", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "275a3495-313c-4c58-9a62-f29048c5b9d6", "name": "List invoice payments", "request": { "name": "List invoice payments", "description": {}, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "59dccdb5-a2cd-4d1d-8232-295482b2e5f6", "name": "Success. Payments for the invoice are returned", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8c7a39dd-b10b-46d1-a1c7-5a62b66f624f", "name": "Get invoice payment", "request": { "name": "Get invoice payment", "description": {}, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "46b657d9-90de-4965-8ffa-8d9952be7aa6", "name": "Success. Specific payment for the invoice is returned", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62024d3e-ef87-4f42-836a-130790978e8c", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ade648ed-a7a3-4189-9752-f52b1c37b706", "name": "Update Invoice Payment", "request": { "name": "Update Invoice Payment", "description": { "content": "External payment methods are payment methods not offered by Elastic Path Subscriptions (such as Elastic Path Payments powered by Stripe or Authorize.net), but they can still be integrated with Subscriptions. You can use the `Update Invoice Payment` endpoint to manually update a payment against an invoice where an external payment method is handling the payment of your invoices. See [External Payments](/docs/api/subscriptions/invoices#external-payments).\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "685188fb-39c7-421e-be67-3659b7fedf59", "name": "Success. Invoice payment has been updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"amount\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"includes_tax\": false\n },\n \"gateway\": \"elastic_path_payments_stripe\",\n \"pending\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": {\n \"reason\": \"Card Failure\"\n }\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"invoice_id\": \"11111111-2222-3333-4444-555555555555\",\n \"subscription_id\": \"11111111-2222-3333-4444-555555555555\",\n \"job_id\": \"11111111-2222-3333-4444-555555555555\",\n \"manual_payment\": false\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e409053-867d-4efa-bd00-6f591cc423c6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcde71ee-6425-44b3-860b-a2fce285e99b", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c202e01-a6e2-4496-8d01-0be4da64d537", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f3eeea5-13ba-47b4-9578-67dab1d28879", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment\",\n \"attributes\": {\n \"success\": true,\n \"external_payment_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"failure_detail\": \"Card Failure\",\n \"payment_taken_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "90156530-b56c-44cc-82b3-ed0a5dd3fd35", "name": "Create a refund for an invoice payment", "request": { "name": "Create a refund for an invoice payment", "description": { "content": "Creates a refund for a paid invoice.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "39f2b63c-5123-4c78-bd4a-e182b9bf01c6", "name": "Success. The payment refund is completed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\",\n \"gateway\": \"elastic_path_payments_stripe\",\n \"external_refund_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_3\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_4\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88f42f0c-3a3a-4649-ad7a-29df161f9606", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a51a4166-2367-4f20-a324-0ebcf92605d0", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97e5f605-3c79-4756-8be7-31bd8721aadd", "name": "Unprocessable Content.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Unprocessable Content\",\n \"status\": \"422\",\n \"detail\": \"Unprocessable Content: cannot process the refund\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3abe9b78-df5a-409d-82ad-ff15a8e11066", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9ed4046b-aa4a-489b-afad-f0aec3ca0780", "name": "List invoice payment refunds", "request": { "name": "List invoice payment refunds", "description": { "content": "List all refunds for an invoice payments", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c39ddc3e-f9cb-46e9-b3a2-2d3e9494959f", "name": "Success. Refunds for an invoice payment are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\",\n \"gateway\": \"elastic_path_payments_stripe\",\n \"external_refund_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n },\n {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\",\n \"gateway\": \"elastic_path_payments_stripe\",\n \"external_refund_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\",\n \"key_2\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2038e629-0446-4250-8a21-513c5226476e", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffffb5e8-df02-4f47-b5f3-7bccd370f653", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "24b7e677-481b-43f5-8c38-cd59ef776609", "name": "Get a refund for an invoice payment", "request": { "name": "Get a refund for an invoice payment", "description": { "content": "Get a refund for a paid invoice.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds", ":refund_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" } }, { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "refund_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of the refund.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "154e08f4-47e0-436a-881b-ebd3c2fe9bd1", "name": "Success. Specific refund for the invoice payment is returned", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds", ":refund_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the refund.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "refund_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_invoice_payment_refund\",\n \"attributes\": {\n \"amount\": 100,\n \"reason\": \"Customer requested cancellation\",\n \"gateway\": \"elastic_path_payments_stripe\",\n \"external_refund_id\": \"33e7ec6b-8b34-4c92-a95b-2e2647922e47\",\n \"created_at\": \"2017-01-10T11:41:19.244842Z\"\n },\n \"relationships\": {\n \"key_0\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_1\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_2\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_3\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n },\n \"key_4\": {\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"11111111-2222-3333-4444-555555555555\"\n },\n \"links\": {\n \"related\": \"foo.bar\"\n }\n }\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "804d1f8b-23d3-47ab-bbed-4406d6acf317", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds", ":refund_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the refund.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "refund_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11bf7a2e-8419-4677-b380-4b93109c44de", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds", ":refund_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the refund.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "refund_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88cd751b-aad7-443e-987c-af6883fba717", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "invoices", ":invoice_uuid", "payments", ":payment_uuid", "refunds", ":refund_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of the invoice.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "invoice_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the payment.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "payment_uuid" }, { "disabled": false, "description": { "content": "(Required) The unique identifier of the refund.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "refund_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Dunning Rules", "description": "\nDunning is the process of handling failed payment attempts. This is important for recovering revenue from failed payments, reduces customer churn and maintains cashflow. By implementing efficient dunning processes, you can enhance financial health and operational efficiency.\n\nSubscriptions enables you to create a dunning rule that allows you to configure payment retry schedules. Subscriptions retries failed payments automatically. You can customize the timing and frequency of the payment retries.\n\nDunning is enabled by default. You can choose to disable dunning. If no dunning rule is configured, then payment is retried once a day for 10 days, in total 11 payments. You can decide what action to take after the Subscriptions has stopped retrying the payments.\n\n- Do nothing - the subscription remains active and Subscriptions does not attempt to retry the payment. However, the subscription is still available for a subscriber to use.\n- Suspend the subscription. Subscriptions does not attempt to retry the payment. A subscriber can choose to pay the outstanding invoice. However, a subscriber cannot renew their subscription; a merchandizer must renew the subscription on behalf of the subscriber.\n- close a subscription. The subscription ends and it's status becomes `inactive`. However, a merchandizer can choose to resume the subscription if a subscriber pays the outstanding payment. \n", "item": [ { "id": "247927e3-e4d5-4adc-89cc-0d3f6c04e91e", "name": "Create a dunning rule", "request": { "name": "Create a dunning rule", "description": { "content": "Dunning rules must use a `fixed` strategy. This means payments are retried on a fixed schedule. \n\nWhen an invoice is created, it immediately becomes eligible for payment by the next payment run. If the first payment attempt fails then the invoice enters dunning. In subsequent payment runs, invoices are only considered for payment if they meet the dunning rules you create.\n\nYou can configure a dunning rule to be the default for your store. There can only be one default rule per store. All invoices in your store will then perform dunning according to the specified rules. \n\n:::note\nIf no dunning rule is configured, then payment is retried once a day for 10 days, in total 11 payments. You can decide what action to take after the Subscriptions has stopped retrying the payments.\n:::\n\nThe following attributes are used to define a `fixed` schedule:\n\n- `payment_retry_unit - the unit of time used to measure the intervals between payment attempts or retries. \n- `payment_retry_interval` - the number of `payment_interval-units` to wait between each payment retry attempt.\n- `payment_retries_limit` - the number of times subscriptions attempts payments retries before an `action` is taken.\n- `action` - the action to take if payment is not successful.\n\nFor example, if:\n\n- the `payment_retry_unit` is `days` \n- the `payment_retry_interval` is `2`\n- the `payment_rety_limit` is `10`\n- the `action` is `close`.\n\nSubscriptions attempts to retry the payment every 2 days until 10 payment attempts have been tried. At that point, the subscription ends and it's status changes to `inacive`. \n\nFollowing on from this, you can specify that the dunning rule is no longer the default. You do not have to specify another rule to replace it. If you do remove the default dunning rule, the store defaults to the behavior that is followed when dunning is not enabled.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "8d4d1945-aaea-4745-b5db-0e4c282d2e65", "name": "Success. The dunning rule set is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a406966-e7ad-46ae-91c0-4301bad156e3", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60835935-a170-4373-9193-f5ffb6bb27ea", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "80a2eb70-43c8-4bd3-9a3f-92065be16283", "name": "List dunning rules", "request": { "name": "List dunning rules", "description": { "content": "Retrieves a list of all dunning rule sets.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "2d69402b-8360-4bc2-a56b-7630020b0679", "name": "Success. A list of dunning rules is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\",\n \"key_1\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aaf7c6d7-de9a-4fc3-95ae-9aef3dd748cb", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62c47bb9-3668-40db-a886-d990b47fdd3a", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "filter", "value": "eq(name,Alan Turing)" }, { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a1f00db5-f8c3-43b1-94c6-a602d862f4fa", "name": "Get dunning rule policy", "request": { "name": "Get dunning rule policy", "description": {}, "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "c49b021d-ea9d-46af-bb75-f19ebae65e11", "name": "Success. The dunning rule details are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "623e9e8d-bb89-485a-9207-941bc3661a67", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e75b064-43af-497f-82b1-874b8675a677", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "691ee213-db5d-4c6f-835c-f5421caf0fd2", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d1e71d57-1626-487d-ae01-319e14be3a08", "name": "Update dunning rule policy", "request": { "name": "Update dunning rule policy", "description": { "content": "Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the rule is not updated. For fields that are optional, an existing value can be removed by specifying a value of null.", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a3f10e0d-f564-46ea-bba1-fcc520b7c3d9", "name": "Success. The dunning rule set has been updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_unit\": \"day\",\n \"payment_retry_interval\": 1,\n \"payment_retries_limit\": 10,\n \"action\": \"none\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92357620-017e-4a6d-9a9c-c95cb0e58a43", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff49a653-5b62-41f9-b3cc-7e10fd64cd10", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44c72c47-3169-45fc-8b01-56f1e1e68e5b", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "841bfa54-71c0-4ea4-b273-2d371061352f", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "300a7d4b-e09f-42e6-9116-5ad780f774f6", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_dunning_rule\",\n \"attributes\": {\n \"payment_retry_type\": \"fixed\",\n \"payment_retry_interval\": 1,\n \"payment_retry_unit\": \"day\",\n \"payment_retry_multiplier\": 1,\n \"payment_retries_limit\": 5,\n \"action\": \"none\",\n \"default\": false\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e090d4a-422d-4e9a-991c-b6446dd8555e", "name": "Delete dunning rules", "request": { "name": "Delete dunning rules", "description": { "content": "You can delete a dunning rule at any time. If a dunning rule is deleted then Subscriptions reverts to the configuration used if no dunning rule is set; payment is retried once a day for 10 days, in total 11 payments. You can decide what action to take after the Subscriptions has stopped retrying the payments. See [Dunning Rules](/docs/api/subscriptions/dunning-rules).", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "2dd83b35-3bda-4534-933c-3f598850f928", "name": "Success. The dunning rule is removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "44a14258-9c2e-4594-8df7-648621530662", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85e44696-55d3-4319-a74d-e2d83384d3f8", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "dunning-rules", ":dunning_rule_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a dunning rule set.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "dunning_rule_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Proration Policies", "description": "Proration is the adjustment of charges or credits on a subscriber's account based on the amount of time a service is used. Proration ensures that subscribers are only charged for the actual time they use the service, whether they upgrade, downgrade, start, or cancel their subscription partway through a billing cycle. This means fair billing for your subscribers and provides you with the flexibility to change your subscribers subscriptions at any time. \n\n::: note\n\nSubscriptions use client credentials to enable changes to subscriptions, so if you want your shoppers to have the ability to make changes, you can implement a BFF layer using this approach.\n\n:::\n\nProration occurs for:\n\n- Pricing option upgrades/downgrades: If a subscriber changes their pricing option in the middle of a billing cycle, proration adjusts the charges to reflect the time spent on each pricing option.\n- Service cancellation: If a subscriber cancels a subscription before the end of a billing cycle, they may receive a prorated invoice for the used portion of the subscription.\n- Mid-cycle subscription: If a subscriber starts a subscription in the middle of a billing cycle, they are charged a prorated amount for the remaining days in the billing cycle.\n\nThere are several scenarios when implementing proration policies.\n\n1. You may want one policy for multiple offerings because only some subscriptions need prorating.\n2. You may want a default proration policy for your store.\n3. You may want several policies for different offerings. \n\nIn Subscriptions, charges only prorate by day. As soon as a subscriber changes their subscription, a manual billing run is triggered and an invoice is generated with the new price on the next billing run and the difference in price is prorated over days. \n\nBy default, proration is not enabled for Subscriptions. Once you have attached a proration policy to an offering, proration is enabled automatically.\n\n### End dates when switching pricing options\n\nSubscriptions manages the subscription end date when shoppers switch from one pricing option to another. Whether or not an end date is configured depends on the end behavior of the pricing options you are switching between.\n\n| Current Subscription | New Subscription | Proration Behavior | End date |\n| --- | --- | --- | --- |\n| `close` | `roll` | The subscription switches from a pricing option with a fixed end date to a rolling pricing option so no end date is set after proration. | No end date is configured. |\n| `roll` | `close` | The subscription switches to a fixed pricing option, and the end date is configured based on the duration of the pricing option. | An end date is configured. |\n| `close` | `close` | The remaining time on the current pricing option is not carried over to the new pricing option. For example, if your current pricing option has 3 months remaining and you switch to a new pricing option that has a fixed length of 6 months, the new end date is calculated as 6 months from the day you switch pricing options, effectively resetting the subscription length to the new pricing option. | New end date calculated from the day you switched pricing option. |\n", "item": [ { "id": "8dc75baa-52b1-43ed-a97a-9c053ccf9eda", "name": "Create a Proration Policy", "request": { "name": "Create a Proration Policy", "description": { "content": "In Subscriptions, you configure proration by creating a proration policy and attaching it to an offering. Once you have [attached](/docs/api/subscriptions/update-offering) the policy, the proration policy applies to all subscriptions that use the offering.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "1076449f-78bb-4edb-bd96-0fbf7cb9a58f", "name": "Success. The proration policy is created.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0faec18-a0d7-428f-8ec7-52dc1052c3d5", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acfbbbfb-1c41-4cec-9caf-6e0cbcefa567", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f7f5c647-da88-48c8-ad16-b9f87a9f37d5", "name": "List proration policies", "request": { "name": "List proration policies", "description": { "content": "Retrieves a list of all proration policies.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9780e0b2-b53a-469c-8a5d-21705be3df7a", "name": "Success. A list of proration policies is returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n },\n {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n ],\n \"links\": {\n \"key_0\": \"http://example.com/articles/1/comments\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d42ece9-74d7-4aab-964d-e855dbec3ba6", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e93d8eee-5266-42be-8479-e54c158a99eb", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[offset]", "value": "10" }, { "disabled": false, "description": { "content": "The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the [page length](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.", "type": "text/plain" }, "key": "page[limit]", "value": "100" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7e22e8b2-8618-4348-bf09-a6bd88c5f0fc", "name": "Get proration policy", "request": { "name": "Get proration policy", "description": {}, "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "379dd5b0-3b73-44e8-bee7-e543c5361364", "name": "Success. The proration policy details are returned.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f8ea045-25d7-42bd-9964-d448592c66d9", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4fdd02b-312f-4f7d-93c8-7b4bd9731f7c", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "927ad298-4e6d-44db-97c7-f0ddee53d470", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0b53deeb-091b-42e3-aca0-ebca7cb46fb8", "name": "Update proration policy", "request": { "name": "Update proration policy", "description": { "content": "You can update a proration policy at any time. For any subscriptions that are using the updated proration policy, the changes are also applied. Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the proration policy is not updated.\n\nWhen updating proration policies:\n\n- You can change the name of an existing policy.\n- You can update `rounding`.\n- You can update `external_ref` as long as `external_ref` is still unique in your store.\n- You can remove `external_ref` as this attribute is optional.\n- You cannot remove any required attributes, such as `name` or `rounding`.\n", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "5edf32f6-0cff-41b3-be4d-2ce0400292fd", "name": "Success. The proration policy details are updated.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"name\": \"Main Policy\",\n \"rounding\": \"up\",\n \"external_ref\": \"abc123\"\n },\n \"meta\": {\n \"owner\": \"store\",\n \"timestamps\": {\n \"created_at\": \"2017-01-10T11:41:19.244842Z\",\n \"updated_at\": \"2017-01-10T11:41:19.244842Z\"\n }\n },\n \"id\": \"11111111-2222-3333-4444-555555555555\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3066b08-f82f-4d65-8bff-6051b46514b0", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "edfdd2f1-a680-4282-b775-b406cb8e3304", "name": "Forbidden. The operation is forbidden on this entity.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Permission denied\",\n \"status\": \"404\",\n \"detail\": \"Permission denied: plan tenancy mismatch\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f5abc86-aaf0-4182-b94d-097ea8564fe4", "name": "Not found. The requested entity does not exist.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Not Found\",\n \"status\": \"404\",\n \"detail\": \"No plan found\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d81e8f15-f4cc-4c0c-b532-6c2cae050022", "name": "Write conflict. Unable to perform the operation at this time.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": {\n \"id\": \"11111111-2222-3333-4444-555555555555\",\n \"type\": \"subscription_proration_policy\",\n \"attributes\": {\n \"external_ref\": \"abc123\",\n \"name\": \"Main Policy\",\n \"rounding\": \"up\"\n }\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Write Conflict\",\n \"status\": \"409\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f3aa1af3-a22f-477c-85c7-7f8014b6b3ef", "name": "Delete proration policy", "request": { "name": "Delete proration policy", "description": { "content": "A proration policy cannot be deleted if it is being used by any subscriptions. This means you must detach a proration policy that you want to delete from any offerings using that policy before deleting the policy. See [Remove a proration policy from an offering](/docs/api/subscriptions/update-offering).", "type": "text/plain" }, "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid", "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "bdf11a16-a98b-4aa2-8088-8f7475abbb8c", "name": "Success. The proration policy details are removed.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a4a9e0b5-3d5e-48fc-9b2b-35ed2835ca7f", "name": "Bad request. The request failed validation.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Validation Error\",\n \"status\": \"400\",\n \"detail\": \"data.attributes.name: \\\"name\\\" is required\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35f732fc-e765-464d-a856-46869130b40f", "name": "Internal server error. There was a system failure in the platform.", "originalRequest": { "url": { "path": [ "v2", "subscriptions", "proration-policies", ":proration_policy_uuid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The unique identifier of a proration policy.", "type": "text/plain" }, "type": "any", "value": "11111111-2222-3333-4444-555555555555", "key": "proration_policy_uuid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n {\n \"title\": \"Internal Server Error\",\n \"status\": \"500\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Observable Events", "description": "You can integrate Subscriptions with external systems like enterprise resource planning, fulfilment and other systems. For example, when a subscriber updates their address, the Customer Relationship Management system is updated with the change. \n\nEvents are actions that occur in Subscriptions, such as a subscriber changing their address or a subscription changing from active to inactive. You can create custom functions that perform additional processing outside of Subscriptions, and create integrations so that when an event occurs in your store, the custom function is run.\n\nEvents are processed concurrently. This means that events may not be delivered in the order they are created. For example, if a subscription is updated multiple times, the events may not be delivered in the same sequence they were updated. Events operate on an \"at least once\" delivery policy. We aim to deliver messages within 30 minutes or less. Ensure that you design your receiving code accordingly.\n\nFor more information about integrating Subscriptions, see [**Integrations (Event Subscriptions/Notifications)**](/docs/api/integrations/integrations-event-subscriptions-notifications#integration-types).\n\n| Resource | Action | Observable Key | Availability |\n| --- | --- | --- | --- |\n| Offering |
  • Created
  • Updated
  • Deleted
|
  • `subscription-offering.created`
  • `subscription-offering.updated`
  • `subscription-offering.deleted`
| Store |\n| Subscription |
  • Created
  • Create-failed
  • Paused
  • Canceled
  • Pending-cancel
  • Pending-pause
  • Resumed
  • Closed
|
  • `subscription.created`
  • `subscription.create-failed`
  • `subscription.canceled`
  • `subscription.paused`
  • `subscription.pending_cancel`
  • `subscription.pending_pause`
  • `subscription.resumed`
  • `subscription.closed`
| Store |\n| Job |
  • Created
  • Updated
  • Deleted
|
  • `subscription-job.created`
  • `subscription-job.updated`
  • `subscription-job.deleted`
| Store |\n| Invoices |
  • Created
  • Deleted
|
  • `subscription-invoice.created`
  • `subscription-invoice.deleted`
| Store |\n| Schedule |
  • Created
  • Updated
  • Deleted
|
  • `subscription-schedule.created`
  • `subscription-schedule.updated`
  • `subscription-schedule.deleted`
| Store |\n| Subscriber |
  • Created
  • Updated
  • Deleted
|
  • `subscription-subscriber.created`
  • `subscription-subscriber.updated`
  • `subscription-subscriber.deleted`
| Store |\n", "item": [] } ], "variable": [ { "key": "baseUrl", "value": "https://useast.api.elasticpath.com", "type": "string" }, { "key": "baseUrl", "value": "https://euwest.api.elasticpath.com", "type": "string" }, { "key": "baseUrl", "value": "https://euwest.api.elasticpath.com/v2", "type": "string" }, { "key": "baseUrl", "value": "https://api.moltin.com", "type": "string" } ], "auth": { "type": "bearer", "bearer": [ { "type": "any", "value": "{{bearerToken}}", "key": "token" } ] } }