Medusa

Get Order Reservations

GET

/admin/orders/{id}/reservations

Orders

Retrieve the list of reservations of an Order

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.medusa-commerce.com/admin/orders//reservations'

Response Example

200 - Example 1

{
  "count": 0,
  "offset": 0,
  "limit": 0,
  "reservations": [
    {
      "id": "string",
      "location_id": "string",
      "inventory_item_id": "string",
      "description": "string",
      "created_by": "string",
      "quantity": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "deleted_at": "2019-08-24T14:15:22Z",
      "metadata": {
        "car": "white"
      },
      "inventory_item": {
        "sku": "string",
        "hs_code": "string",
        "origin_country": "string",
        "mid_code": "string",
        "title": "string",
        "description": "string",
        "thumbnail": "string",
        "material": "string",
        "weight": 0,
        "height": 0,
        "width": 0,
        "length": 0,
        "requires_shipping": true,
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z",
        "metadata": {
          "car": "white"
        }
      },
      "line_item": {
        "id": "item_01G8ZC9GWT6B2GP5FSXRXNFNGN",
        "cart_id": "cart_01G8ZH853Y6TFXWPG5EYE81X63",
        "cart": {},
        "order_id": "order_01G8TJSYT9M6AVS5N4EMNFS1EK",
        "order": {},
        "swap_id": null,
        "swap": {},
        "claim_order_id": null,
        "claim_order": {},
        "original_item_id": "string",
        "order_edit_id": "string",
        "order_edit": {},
        "title": "Medusa Coffee Mug",
        "description": "One Size",
        "thumbnail": "https://medusa-public-images.s3.eu-west-1.amazonaws.com/coffee-mug.png",
        "is_return": false,
        "is_giftcard": false,
        "should_merge": true,
        "allow_discounts": true,
        "has_shipping": false,
        "unit_price": 8000,
        "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
        "quantity": 1,
        "fulfilled_quantity": 0,
        "returned_quantity": 0,
        "shipped_quantity": 0,
        "refundable": 0,
        "subtotal": 8000,
        "tax_total": 0,
        "total": 8000,
        "original_total": 8000,
        "original_tax_total": 0,
        "discount_total": 0,
        "raw_discount_total": 0,
        "gift_card_total": 0,
        "includes_tax": false,
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "metadata": {
          "car": "white"
        },
        "tax_lines": [
          {
            "id": "litl_01G1G5V2DRX1SK6NQQ8VVX4HQ8",
            "code": "tax01",
            "name": "Tax Example",
            "rate": 10,
            "item_id": "item_01G8ZC9GWT6B2GP5FSXRXNFNGN",
            "item": {},
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z",
            "metadata": {
              "car": "white"
            }
          }
        ],
        "variant": {
          "id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
          "title": "Small",
          "product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
          "product": {},
          "sku": "shirt-123",
          "barcode": null,
          "ean": null,
          "upc": null,
          "variant_rank": 0,
          "inventory_quantity": 100,
          "allow_backorder": false,
          "manage_inventory": true,
          "hs_code": null,
          "origin_country": null,
          "mid_code": null,
          "material": null,
          "weight": null,
          "length": null,
          "height": null,
          "width": null,
          "created_at": "2019-08-24T14:15:22Z",
          "updated_at": "2019-08-24T14:15:22Z",
          "deleted_at": "2019-08-24T14:15:22Z",
          "purchasable": true,
          "metadata": {
            "car": "white"
          },
          "options": [
            {
              "id": "optval_01F0YESHR7S6ECD03RF6W12DSJ",
              "value": "large",
              "option_id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
              "option": {},
              "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
              "variant": {},
              "created_at": "2019-08-24T14:15:22Z",
              "updated_at": "2019-08-24T14:15:22Z",
              "deleted_at": "2019-08-24T14:15:22Z",
              "metadata": {
                "car": "white"
              }
            }
          ],
          "inventory_items": [
            {
              "id": "pvitem_01G8X9A7ESKAJXG2H0E6F1MW7A",
              "inventory_item_id": "string",
              "variant_id": "string",
              "variant": {},
              "required_quantity": 1,
              "created_at": "2019-08-24T14:15:22Z",
              "updated_at": "2019-08-24T14:15:22Z",
              "deleted_at": "2019-08-24T14:15:22Z"
            }
          ],
          "prices": [
            {
              "id": "ma_01F0YESHRFQNH5S8Q0PK84YYZN",
              "amount": 100,
              "min_quantity": 1,
              "max_quantity": 1,
              "price_list_id": "pl_01G8X3CKJXCG5VXVZ87H9KC09W",
              "price_list": {},
              "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
              "variant": {},
              "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
              "region": {},
              "created_at": "2019-08-24T14:15:22Z",
              "updated_at": "2019-08-24T14:15:22Z",
              "deleted_at": "2019-08-24T14:15:22Z",
              "currency_code": "usd",
              "currency": {
                "symbol": "$",
                "symbol_native": "$",
                "name": "US Dollar",
                "includes_tax": false,
                "code": "usd"
              }
            }
          ]
        },
        "adjustments": [
          {
            "id": "lia_01G8TKE4XYCTHSCK2GDEP47RE1",
            "item_id": "item_01G8ZC9GWT6B2GP5FSXRXNFNGN",
            "item": {},
            "description": "Adjusted item's price.",
            "discount_id": "disc_01F0YESMW10MGHWJKZSDDMN0VN",
            "amount": 1000,
            "metadata": {
              "car": "white"
            },
            "discount": {
              "id": "disc_01F0YESMW10MGHWJKZSDDMN0VN",
              "code": "10DISC",
              "is_dynamic": false,
              "rule_id": "dru_01F0YESMVK96HVX7N419E3CJ7C",
              "is_disabled": false,
              "parent_discount_id": "disc_01G8ZH853YPY9B94857DY91YGW",
              "parent_discount": {},
              "starts_at": "2019-08-24T14:15:22Z",
              "ends_at": "2019-08-24T14:15:22Z",
              "valid_duration": "P3Y6M4DT12H30M5S",
              "usage_limit": 100,
              "usage_count": 0,
              "created_at": "2019-08-24T14:15:22Z",
              "updated_at": "2019-08-24T14:15:22Z",
              "deleted_at": "2019-08-24T14:15:22Z",
              "metadata": {
                "car": "white"
              },
              "rule": {
                "id": "dru_01F0YESMVK96HVX7N419E3CJ7C",
                "description": "10 Percent",
                "value": 10,
                "created_at": "2019-08-24T14:15:22Z",
                "updated_at": "2019-08-24T14:15:22Z",
                "deleted_at": "2019-08-24T14:15:22Z",
                "type": "fixed",
                "allocation": "total",
                "conditions": [
                  {}
                ],
                "metadata": {
                  "car": "white"
                }
              },
              "regions": [
                {
                  "id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                  "name": "EU",
                  "tax_rate": 0,
                  "tax_code": null,
                  "gift_cards_taxable": true,
                  "automatic_taxes": true,
                  "tax_provider_id": null,
                  "includes_tax": false,
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "currency_code": "usd",
                  "metadata": {
                    "car": "white"
                  },
                  "currency": {
                    "symbol": "$",
                    "symbol_native": "$",
                    "name": "US Dollar",
                    "includes_tax": false,
                    "code": "usd"
                  },
                  "countries": [
                    {
                      "id": 109,
                      "name": "ITALY",
                      "display_name": "Italy",
                      "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                      "region": {},
                      "iso_2": "it",
                      "iso_3": "ita",
                      "num_code": 380
                    }
                  ],
                  "tax_provider": {
                    "id": "manual",
                    "is_installed": true
                  },
                  "payment_providers": [
                    {
                      "id": "manual",
                      "is_installed": true
                    }
                  ],
                  "fulfillment_providers": [
                    {
                      "id": "manual",
                      "is_installed": true
                    }
                  ],
                  "tax_rates": [
                    {
                      "id": "txr_01G8XDBAWKBHHJRKH0AV02KXBR",
                      "rate": 10,
                      "code": "tax01",
                      "name": "Tax Example",
                      "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                      "region": {},
                      "product_count": 10,
                      "product_type_count": 2,
                      "shipping_option_count": 1,
                      "created_at": "2019-08-24T14:15:22Z",
                      "updated_at": "2019-08-24T14:15:22Z",
                      "metadata": {
                        "car": "white"
                      },
                      "product_types": [
                        {
                          "id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                          "value": "Clothing",
                          "created_at": "2019-08-24T14:15:22Z",
                          "updated_at": "2019-08-24T14:15:22Z",
                          "deleted_at": "2019-08-24T14:15:22Z",
                          "metadata": {
                            "car": "white"
                          }
                        }
                      ],
                      "shipping_options": [
                        {
                          "id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
                          "name": "PostFake Standard",
                          "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                          "region": {},
                          "profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                          "provider_id": "manual",
                          "amount": 200,
                          "is_return": false,
                          "admin_only": false,
                          "includes_tax": false,
                          "created_at": "2019-08-24T14:15:22Z",
                          "updated_at": "2019-08-24T14:15:22Z",
                          "deleted_at": "2019-08-24T14:15:22Z",
                          "price_type": "flat_rate",
                          "data": {},
                          "metadata": {
                            "car": "white"
                          },
                          "provider": {
                            "id": "manual",
                            "is_installed": true
                          },
                          "requirements": [
                            {
                              "shipping_option": {}
                            }
                          ],
                          "profile": {
                            "id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                            "name": "Default Shipping Profile",
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "type": "default",
                            "products": [
                              {}
                            ],
                            "shipping_options": [
                              {}
                            ],
                            "metadata": {
                              "car": "white"
                            }
                          }
                        }
                      ],
                      "products": [
                        {
                          "id": "prod_01G1G5V2MBA328390B5AXJ610F",
                          "title": "Medusa Coffee Mug",
                          "subtitle": "string",
                          "description": "Every programmer's best friend.",
                          "handle": "coffee-mug",
                          "is_giftcard": false,
                          "thumbnail": "http://example.com",
                          "profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                          "weight": null,
                          "length": null,
                          "height": null,
                          "width": null,
                          "hs_code": null,
                          "origin_country": null,
                          "mid_code": null,
                          "material": null,
                          "collection_id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
                          "type_id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                          "discountable": true,
                          "external_id": null,
                          "created_at": "2019-08-24T14:15:22Z",
                          "updated_at": "2019-08-24T14:15:22Z",
                          "deleted_at": "2019-08-24T14:15:22Z",
                          "status": "draft",
                          "metadata": {
                            "car": "white"
                          },
                          "images": [
                            {
                              "metadata": {}
                            }
                          ],
                          "categories": [
                            {
                              "parent_category": {},
                              "category_children": [],
                              "products": []
                            }
                          ],
                          "collection": {
                            "id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
                            "title": "Summer Collection",
                            "handle": "summer-collection",
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "products": [
                              {}
                            ],
                            "metadata": {
                              "car": "white"
                            }
                          },
                          "tags": [
                            {
                              "metadata": {}
                            }
                          ],
                          "profile": {
                            "id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                            "name": "Default Shipping Profile",
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "type": "default",
                            "products": [
                              {}
                            ],
                            "shipping_options": [
                              {}
                            ],
                            "metadata": {
                              "car": "white"
                            }
                          },
                          "profiles": [
                            {
                              "products": [],
                              "shipping_options": [],
                              "metadata": {}
                            }
                          ],
                          "type": {
                            "id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                            "value": "Clothing",
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "metadata": {
                              "car": "white"
                            }
                          },
                          "sales_channels": [
                            {
                              "metadata": {},
                              "locations": []
                            }
                          ],
                          "options": [
                            {
                              "product": {},
                              "metadata": {},
                              "values": []
                            }
                          ],
                          "variants": [
                            {
                              "product": {},
                              "metadata": {},
                              "options": [],
                              "inventory_items": [],
                              "prices": []
                            }
                          ]
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

Request

Path Params

string

required

The ID of the Order.

Query Params

offset

integer

optional

The number of reservations to skip when retrieving the reservations.

limit

integer

optional

Limit the number of reservations returned.

Responses

🟢200OK

application/json

Body

count

integer

required

The total number of items available

offset

integer

required

The number of reservations skipped when retrieving the reservations.

limit

integer

required

The number of items per page

reservations

array[object (ExtendedReservationItem) {12}]

required

An array of reservations details.

string

required

The id of the reservation item

location_id

string

required

The id of the location of the reservation

inventory_item_id

string

required

The id of the inventory item the reservation relates to

description

string

optional

Description of the reservation item

created_by

string

optional

UserId of user who created the reservation item

quantity

number

required

The id of the reservation item

created_at

string <date-time>

optional

The date with timezone at which the resource was created.

updated_at

string <date-time>

optional

The date with timezone at which the resource was updated.

deleted_at

string <date-time>

optional

The date with timezone at which the resource was deleted.

metadata

object

optional

An optional key-value map with additional details

Example:

{"car":"white"}

inventory_item

object

InventoryItemDTO

optional

line_item

object

Line Item

optional

Line Items are created when a product is added to a Cart. When Line Items are purchased they will get copied to the resulting order, swap, or claim, and can eventually be referenced in Fulfillments and Returns. Line items may also be used for order edits.

🟠400Client Error or Multiple Errors

🟠401User is not authorized. Must log in first

🟠404Not Found Error

🟠409Invalid State Error

🟠422Invalid Request Error

🔴500Server Error

Modified at 2023-10-10 11:56:36

Cancel Swap's Fulfilmment

Add a Shipping Method