Medusa
Store APIAdmin API
Store APIAdmin API
Discord
Twitter
Linkedin
Github
  1. Regions
  • Auth
    • Get Current User
      GET
    • User Logout
      DELETE
    • User Login
      POST
    • User Login (JWT)
      POST
  • Apps Oauth
    • Generate Token for App
      POST
    • List Applications
      GET
  • Batch Jobs
    • Cancel a Batch Job
      POST
    • Get a Batch Job
      GET
    • Confirm a Batch Job
      POST
    • List Batch Jobs
      GET
    • Create a Batch Job
      POST
  • Currencies
    • List Currency
      GET
    • Update a Currency
      POST
  • Customers
    • Create a Customer
    • List Customers
    • Update a Customer
    • Get a Customer
  • Customer Groups
    • Remove Customers from Group
    • Add Customers to Group
    • List Customers
    • Create a Customer Group
    • List Customer Groups
    • Get a Customer Group
    • Delete a Customer Group
    • Update a Customer Group
  • Discounts
    • Create a Condition
    • Create a Discount
    • List Discounts
    • Get a Condition
    • Update a Condition
    • Delete a Condition
    • Create a Dynamic Code
    • Remove Batch Resources
    • Add Batch Resources
    • Get Discount by Code
    • Delete a Dynamic Code
    • Add Region to Discount
    • Remove Region
    • Delete a Discount
    • Update a Discount
    • Get a Discount
  • Draft Orders
    • Create a Line Item
    • Delete a Line Item
    • Update a Line Item
    • Update a Draft Order
    • Delete a Draft Order
    • Get a Draft Order
    • Create a Draft Order
    • List Draft Orders
    • Mark Paid
  • Gift Cards
    • Create a Gift Card
    • List Gift Cards
    • Delete a Gift Card
    • Get a Gift Card
    • Update a Gift Card
  • Inventory Items
    • Create an Inventory Item
    • List Inventory Items
    • List Inventory Level
    • Create an Location Level
    • Update an Inventory Item
    • Get an Inventory Item
    • Delete an Inventory Item
    • Update a Location Level
    • Delete a Location Level
  • Invites
    • Lists Invites
    • Create an Invite
    • Delete an Invite
    • Accept an Invite
    • Resend an Invite
  • Notes
    • List Notes
    • Create a Note
    • Get a Note
    • Delete a Note
    • Update a Note
  • Notifications
    • Resend Notification
    • List Notifications
  • Orders
    • Create a Reservation
    • Cancel Claim's Fulfillment
    • Ship a Claim's Fulfillment
    • Cancel Swap's Fulfilmment
    • Get Order Reservations
    • Add a Shipping Method
    • Create a Refund
    • Get an Order
    • Update an Order
    • Create a Fulfillment
    • Cancel a Swap
    • List Orders
    • Create a Swap
    • Complete an Order
    • Create a Swap Fulfillment
    • Cancel a Claim
    • Process a Swap Payment
    • Ship a Fulfillment
    • Capture an Order's Payments
    • Archive Order
    • Update a Claim
    • Request a Return
    • Create a Claim Fulfillment
    • Ship a Swap's Fulfillment
    • Cancel a Fulfilmment
    • Create a Claim
    • Cancel an Order
  • Order Edits
    • Delete a Line Item Change
    • Add a Line Item
    • Upsert Line Item Change
    • Delete Line Item
    • Cancel an Order Edit
    • Delete an Order Edit
    • Get an Order Edit
    • Update an Order Edit
    • Request Confirmation
    • Create an OrderEdit
    • List Order Edits
    • Confirm an OrderEdit
  • Payments
    • Capture a Payment
    • Get Payment details
    • Refund Payment
  • Payment Collections
    • Delete a Payment Collection
    • Get a Payment Collection
    • Update Payment Collection
    • Mark Authorized
  • Product Collections
    • Add Products to Collection
    • Remove Products from Collection
    • Get a Collection
    • Update a Collection
    • Delete a Collection
    • List Collections
    • Create a Collection
  • Product Tags
    • List Product Tags
  • Product Types
    • List Product Types
  • Product Variants
    • Get Variant's Inventory
    • List Product Variants
    • Get a Product variant
  • Price Lists
    • Delete a Product's Prices
    • List Products
    • Delete a Variant's Prices
    • Get a Price List
    • Update a Price List
    • Delete a Price List
    • Add or Update Prices
    • Delete Prices
    • Create a Price List
    • List Price Lists
  • Products
    • List Product Types
    • List Tags Usage Number
    • List a Product's Variants
    • Create a Product Variant
    • Update a Product Variant
    • Delete a Product Variant
    • Add a Product Option
    • Set Metadata
    • Delete a Product Option
    • Update a Product Option
    • List Products
    • Create a Product
    • Delete a Product
    • Update a Product
    • Get a Product
  • Product Categories
    • Create a Product Category
    • List Product Categories
    • Update a Product Category
    • Delete a Product Category
    • Get a Product Category
    • Add Products to a Category
    • Remove Products from Category
  • Publishable Api Keys
    • List Sales Channels
    • Delete Publishable API Key
    • Get a Publishable API Key
    • Revoke a Publishable API Key
    • Remove Sales Channels
    • Add Sales Channels
    • Update Publishable API Key
    • List Publishable API keys
    • Create Publishable API Key
  • Reservations
    • Delete a Reservation
    • Update a Reservation
    • Get a Reservation
    • Create a Reservation
    • List Reservations
  • Regions
    • List Fulfillment Options
      GET
    • Add Country
      POST
    • Remove Fulfillment Provider
      DELETE
    • Remove Payment Provider
      DELETE
    • Add Payment Provider
      POST
    • Delete a Region
      DELETE
    • Update a Region
      POST
    • Get a Region
      GET
    • List Regions
      GET
    • Create a Region
      POST
    • Add Fulfillment Provider
      POST
    • Remove Country
      DELETE
  • Return Reasons
    • Get a Return Reason
    • Delete a Return Reason
    • Update a Return Reason
    • List Return Reasons
    • Create a Return Reason
  • Returns
    • Receive a Return
    • List Returns
    • Cancel a Return
  • Sales Channels
    • Remove Stock Location from Sales Channels.
    • Associate a Stock Location
    • Get a Sales Channel
    • Delete a Sales Channel
    • Update a Sales Channel
    • Remove Products from Sales Channel
    • Add Products to Sales Channel
    • Create a Sales Channel
    • List Sales Channels
  • Shipping Options
    • Update Shipping Option
    • Get a Shipping Option
    • Delete Shipping Option
    • List Shipping Options
    • Create Shipping Option
  • Shipping Profiles
    • List Shipping Profiles
    • Create a Shipping Profile
    • Delete a Shipping Profile
    • Update a Shipping Profile
    • Get a Shipping Profile
  • Stock Locations
    • Get a Stock Location
    • List Stock Locations
    • Create a Stock Location
    • Update a Stock Location
    • Delete a Stock Location
  • Store
    • List Payment Providers
    • Add a Currency Code
    • Remove a Currency
    • List Tax Providers
    • Update Store Details
    • Get Store details
  • Swaps
    • Get a Swap
    • List Swaps
  • Uploads
    • Upload Files
    • Delete an Uploaded File
    • Get a File's Download URL
    • Protected File Upload
  • Tax Rates
    • Add to Shipping Options
    • Remove Shipping Options from Rate
    • Create a Tax Rate
    • List Tax Rates
    • Add to Products
    • Remove Products from Rate
    • Delete a Tax Rate
    • Get a Tax Rate
    • Update a Tax Rate
    • Add to Product Types
    • Remove Product Types from Rate
  • Users
    • Reset Password
    • Request Password Reset
    • Get a User
    • Delete a User
    • Update a User
    • Create a User
    • List Users
  1. Regions

List Regions

GET
/admin/regions
Regions
Retrieve a list of Regions. The regions can be filtered by fields such as created_at. The regions can also be paginated
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '{{BASE_URL}}/admin/regions'
Response Response Example
200 - Example 1
{
  "count": 0,
  "offset": 0,
  "limit": 0,
  "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": [
                {
                  "id": "sor_01G1G5V29AB4CTNDRFSRWSRKWD",
                  "shipping_option_id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
                  "shipping_option": {},
                  "amount": 100,
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "type": "min_subtotal"
                }
              ],
              "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": [
                {
                  "id": "img_01G749BFYR6T8JTVW6SGW3K3E6",
                  "url": "http://example.com",
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "metadata": {
                    "car": "white"
                  }
                }
              ],
              "categories": [
                {
                  "id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
                  "name": "Regular Fit",
                  "handle": "regular-fit",
                  "mpath": "pcat_id1.pcat_id2.pcat_id3",
                  "is_internal": false,
                  "is_active": false,
                  "rank": 0,
                  "parent_category_id": null,
                  "parent_category": {},
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "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": [
                {
                  "id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
                  "value": "Pants",
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "metadata": {
                    "car": "white"
                  }
                }
              ],
              "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": [
                {
                  "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"
                  }
                }
              ],
              "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": [
                {
                  "id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                  "name": "Market",
                  "description": "Multi-vendor market",
                  "is_disabled": false,
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "metadata": {
                    "car": "white"
                  },
                  "locations": [
                    {
                      "id": "scloc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                      "sales_channel_id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                      "location_id": "string",
                      "sales_channel": {},
                      "created_at": "2019-08-24T14:15:22Z",
                      "updated_at": "2019-08-24T14:15:22Z",
                      "deleted_at": "2019-08-24T14:15:22Z"
                    }
                  ]
                }
              ],
              "options": [
                {
                  "id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
                  "title": "Size",
                  "product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
                  "product": {},
                  "created_at": "2019-08-24T14:15:22Z",
                  "updated_at": "2019-08-24T14:15:22Z",
                  "deleted_at": "2019-08-24T14:15:22Z",
                  "metadata": {
                    "car": "white"
                  },
                  "values": [
                    {
                      "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"
                      }
                    }
                  ]
                }
              ],
              "variants": [
                {
                  "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"
                      }
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Request

Query Params
limit
integer 
optional
Limit the number of regions returned.
offset
integer 
optional
The number of regions to skip when retrieving the regions.
lt
array[string]
optional
filter by dates less than this date
Example:
["","",""]
gt
array[string]
optional
filter by dates greater than this date
Example:
["","",""]
lte
array[string]
optional
filter by dates less than or equal to this date
Example:
["","",""]
gte
array[string]
optional
filter by dates greater than or equal to this date
Example:
["","",""]

Responses

🟢200OK
application/json
Body
count
integer 
required
The total number of items available
offset
integer 
required
The number of regions skipped when retrieving the regions.
limit
integer 
required
The number of items per page
regions
array[object (Region) {19}] 
required
An array of regions details.
id
string 
required
The region's ID
Example:
reg_01G1G5V26T9H8Y0M4JNE3YGA4G
name
string 
required
The name of the region as displayed to the customer. If the Region only has one country it is recommended to write the country name.
Example:
EU
tax_rate
number 
required
The tax rate that should be charged on purchases in the Region.
Example:
0
tax_code
string  | null 
required
The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.
Example:
null
gift_cards_taxable
boolean 
required
Whether the gift cards are taxable or not in this region.
Default:
true
automatic_taxes
boolean 
required
Whether taxes should be automated in this region.
Default:
true
tax_provider_id
string  | null 
required
The ID of the tax provider used in this region
Example:
null
includes_tax
boolean 
optional
Whether the prices for the region include tax
Default:
false
created_at
string <date-time>
required
The date with timezone at which the resource was created.
updated_at
string <date-time>
required
The date with timezone at which the resource was updated.
deleted_at
string <date-time> | null 
required
The date with timezone at which the resource was deleted.
currency_code
string 
required
The 3 character currency code used in the region.
Example:
usd
metadata
object  | null 
required
An optional key-value map with additional details
Example:
{"car":"white"}
currency
object (Currency) 
optional
Currency
countries
array[object (Country) {8}] 
optional
The details of the countries included in this region.
tax_provider
object (Tax Provider) 
optional
A tax provider represents a tax service installed in the Medusa backend, either through a plugin or backend customizations. It holds the tax service's installation status.
payment_providers
array[object (Payment Provider) {2}] 
optional
The details of the payment providers that can be used to process payments in the region.
fulfillment_providers
array[object (Fulfillment Provider) {2}] 
optional
The details of the fulfillment providers that can be used to fulfill items of orders and similar resources in the region.
tax_rates
array[object (Tax Rate) {15}] 
optional
The details of the tax rates used in the region, aside from the default rate.
🟠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
Previous
Get a Region
Next
Create a Region
Built with