{ "opencollection": "1.0.0", "info": { "name": "Addresses Introduction Account Addresses Cart Management API", "version": "25.1126.6886238" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Cart Management", "type": "folder" }, "items": [ { "info": { "name": "Get Carts", "type": "http" }, "http": { "method": "GET", "url": "https://useast.api.elasticpath.com/v2/carts", "headers": [ { "name": "EP-Account-Management-Authentication-Token", "value": "" }, { "name": "X-Moltin-Customer-Token", "value": "" } ], "params": [ { "name": "include", "value": "", "type": "query" }, { "name": "page[limit]", "value": "", "type": "query", "description": "The maximum number of records per page." }, { "name": "page[offset]", "value": "", "type": "query", "description": "The number of records to offset the results by." }, { "name": "filter", "value": "", "type": "query", "description": "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" } ] }, "docs": "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-accou" }, { "info": { "name": "Create a Cart", "type": "http" }, "http": { "method": "POST", "url": "https://useast.api.elasticpath.com/v2/carts", "headers": [ { "name": "EP-Account-Management-Authentication-Token", "value": "" }, { "name": "X-Moltin-Customer-Token", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "\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 crea" }, { "info": { "name": "Get a Cart", "type": "http" }, "http": { "method": "GET", "url": "https://useast.api.elasticpath.com/v2/carts/:cartID", "params": [ { "name": "cartID", "value": "", "type": "path", "description": "The unique identifier for this cart that you created." }, { "name": "include", "value": "", "type": "query" } ] }, "docs": "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 secti" }, { "info": { "name": "Update a Cart", "type": "http" }, "http": { "method": "PUT", "url": "https://useast.api.elasticpath.com/v2/carts/:cartID", "params": [ { "name": "cartID", "value": "", "type": "path", "description": "The unique identifier of a cart created by you." } ], "body": { "type": "json", "data": "{}" } }, "docs": "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 de" }, { "info": { "name": "Delete a Cart", "type": "http" }, "http": { "method": "DELETE", "url": "https://useast.api.elasticpath.com/v2/carts/:cartID", "params": [ { "name": "cartID", "value": "", "type": "path", "description": "The unique identifier of the cart that you want to delete." } ] }, "docs": "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" } ] } ], "bundled": true }