Store APICarts
Create Cart
Create a cart.
Query Parameters
fields?string
Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.
Header Parameters
x-publishable-api-key*string
Publishable API Key created in the Medusa Admin.
Request Body
application/json
region_id?string
The ID of the cart's region. This affects the prices and currency of the cart.
shipping_address?
The address's details.
billing_address?
The address's details.
email?string
The email of the cart's customer.
Format
emailcurrency_code?string
The cart's currency code. If not provided, the region's currency is used. This affects prices in the cart, as well.
items?
The cart's items.
sales_channel_id?string
The ID of the sales channel that cart is created in. Only products available in that sales channel can be added to the cart. If not provided, the store's default sales channel is associated with the cart instead.
metadata?object
The cart's metadata, can hold custom key-value pairs.
additional_data?object
Pass additional custom data to the API route. This data is passed to the underlying workflow under the additional_data parameter.
Response Body
application/json
application/json
text/plain
application/json
application/json
application/json
application/json
curl -X POST "https://{tenant}.api.myxclade.com/store/carts" \ -H "x-publishable-api-key: string" \ -H "Content-Type: application/json" \ -d '{}'{
"cart": {
"id": "string",
"region": {
"id": "string",
"name": "string",
"currency_code": "usd",
"automatic_taxes": true,
"countries": [
{
"id": "string",
"iso_2": "us",
"iso_3": "usa",
"num_code": 840,
"name": "string",
"display_name": "string"
}
],
"payment_providers": [
{
"id": "string",
"is_enabled": true
}
],
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"region_id": "string",
"customer_id": "string",
"sales_channel_id": "string",
"email": "user@example.com",
"currency_code": "usd",
"shipping_address": {
"id": "string",
"customer_id": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"company": "string",
"address_1": "string",
"address_2": "string",
"city": "string",
"country_code": "us",
"province": "us-ca",
"postal_code": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"billing_address": {
"id": "string",
"customer_id": "string",
"first_name": "string",
"last_name": "string",
"phone": "string",
"company": "string",
"address_1": "string",
"address_2": "string",
"city": "string",
"country_code": "us",
"province": "us-ca",
"postal_code": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"items": [
{
"id": "string",
"title": "string",
"subtitle": "string",
"thumbnail": "string",
"quantity": 0,
"product": {
"categories": [
{}
],
"type": {
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"length": 0,
"title": "string",
"status": "draft",
"options": [
{
"id": "string",
"title": "string",
"product": {},
"product_id": "string",
"values": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"description": "string",
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"variants": [
{
"options": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"product": {},
"length": 0,
"title": "string",
"metadata": {},
"id": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"product_id": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"variant_rank": 0,
"calculated_price": {
"id": "string",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 0,
"calculated_amount_with_tax": 0,
"calculated_amount_without_tax": 0,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 0,
"currency_code": "usd",
"calculated_price": {},
"original_price": {},
"original_amount_with_tax": 0,
"original_amount_without_tax": 0
}
}
],
"handle": "string",
"subtitle": "string",
"is_giftcard": true,
"thumbnail": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"collection": {
"id": "string",
"title": "string",
"handle": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"products": [
{}
],
"metadata": {}
},
"collection_id": "string",
"type_id": "string",
"tags": [
{
"id": "string",
"value": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
}
],
"images": [
{
"id": "string",
"url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {},
"rank": 0
}
],
"discountable": true,
"external_id": "string",
"deleted_at": "2019-08-24T14:15:22Z"
},
"product_id": "string",
"product_title": "string",
"product_description": "string",
"product_subtitle": "string",
"product_type": "string",
"product_collection": "string",
"product_handle": "string",
"variant": {
"options": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"product": {},
"length": 0,
"title": "string",
"metadata": {},
"id": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"product_id": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"variant_rank": 0,
"calculated_price": {
"id": "string",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 0,
"calculated_amount_with_tax": 0,
"calculated_amount_without_tax": 0,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 0,
"currency_code": "usd",
"calculated_price": {},
"original_price": {},
"original_amount_with_tax": 0,
"original_amount_without_tax": 0
}
},
"variant_id": "string",
"variant_sku": "string",
"variant_barcode": "string",
"variant_title": "string",
"variant_option_values": {
"Color": "Red"
},
"requires_shipping": true,
"is_discountable": true,
"is_tax_inclusive": true,
"compare_at_unit_price": 0,
"unit_price": 0,
"tax_lines": [
{
"item": {},
"item_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"item": {},
"item_id": "string",
"id": "string",
"code": "string",
"amount": 0,
"cart_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"cart": {},
"cart_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0
}
],
"shipping_methods": [
{
"id": "string",
"cart_id": "string",
"name": "string",
"description": "string",
"amount": 0,
"is_tax_inclusive": true,
"shipping_option_id": "string",
"data": {},
"metadata": {},
"tax_lines": [
{
"shipping_method": {},
"shipping_method_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"shipping_method": {},
"id": "string",
"code": "string",
"amount": 0,
"cart_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0
}
],
"payment_collection": {
"id": "string",
"currency_code": "string",
"amount": 0,
"authorized_amount": 0,
"captured_amount": 0,
"refunded_amount": 0,
"completed_at": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"status": "canceled",
"payment_providers": [
{
"id": "string"
}
],
"payment_sessions": [
{
"id": "string",
"amount": 0,
"currency_code": "usd",
"provider_id": "string",
"data": {},
"context": {
"customer": {
"id": "cus_123"
}
},
"status": "authorized",
"authorized_at": "2019-08-24T14:15:22Z",
"payment_collection": {},
"payment": {
"id": "string",
"amount": 0,
"authorized_amount": 0,
"currency_code": "string",
"provider_id": "string",
"data": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"captured_at": "2019-08-24T14:15:22Z",
"canceled_at": "2019-08-24T14:15:22Z",
"captured_amount": 0,
"refunded_amount": 0,
"captures": [
{
"id": "string",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"created_by": "string",
"payment": {}
}
],
"refunds": [
{
"id": "string",
"amount": 0,
"refund_reason_id": "string",
"note": "string",
"created_at": "2019-08-24T14:15:22Z",
"created_by": "string",
"payment": {},
"refund_reason": {
"id": "string",
"label": "string",
"description": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"code": "string"
}
}
],
"payment_collection": {},
"payment_session": {}
}
}
],
"payments": [
{
"id": "string",
"amount": 0,
"authorized_amount": 0,
"currency_code": "string",
"provider_id": "string",
"data": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"captured_at": "2019-08-24T14:15:22Z",
"canceled_at": "2019-08-24T14:15:22Z",
"captured_amount": 0,
"refunded_amount": 0,
"captures": [
{
"id": "string",
"amount": 0,
"created_at": "2019-08-24T14:15:22Z",
"created_by": "string",
"payment": {}
}
],
"refunds": [
{
"id": "string",
"amount": 0,
"refund_reason_id": "string",
"note": "string",
"created_at": "2019-08-24T14:15:22Z",
"created_by": "string",
"payment": {},
"refund_reason": {
"id": "string",
"label": "string",
"description": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"code": "string"
}
}
],
"payment_collection": {},
"payment_session": {}
}
]
},
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"original_item_total": 0,
"original_item_subtotal": 0,
"original_item_tax_total": 0,
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0,
"gift_card_total": 0,
"gift_card_tax_total": 0,
"shipping_total": 0,
"shipping_subtotal": 0,
"shipping_tax_total": 0,
"original_shipping_total": 0,
"original_shipping_subtotal": 0,
"original_shipping_tax_total": 0,
"promotions": [
{
"id": "string",
"code": "string",
"is_automatic": true,
"application_method": {
"value": "string",
"type": "fixed",
"currency_code": "string"
}
}
]
}
}{
"message": "Discount must be set to dynamic",
"type": "not_allowed"
}"Unauthorized"{
"message": "Entity with id 1 was not found",
"type": "not_found"
}{
"code": "unknown_error",
"message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
"type": "QueryRunnerAlreadyReleasedError"
}{
"code": "invalid_request_error",
"message": "Discount with code TEST already exists.",
"type": "duplicate_error"
}{
"code": "api_error",
"message": "An error occured while hashing password",
"type": "database_error"
}Get a Cart
Retrieve a cart by its ID. You can expand the cart's relations or select the fields that should be returned.
Update a Cart
Update a cart's details. This unsets the payment methods chosen before, and the customer would have to choose them again. Also, if the customer has chosen a shipping method whose option isn't valid for the cart's shipping address anymore, the shipping method will be unset. For example, if the shipping option is valid only in the US geo zone, and the shipping address's country code is `DE`, the shipping method will be unset.