--- displayed_sidebar: jsClientSidebar slug: /references/js-client/AdminRegionsResource --- import ParameterTypes from "@site/src/components/ParameterTypes" # AdminRegionsResource This class is used to send requests to [Admin Region API Routes](https://docs.medusajs.com/api/admin#regions). All its method are available in the JS Client under the `medusa.admin.regions` property. All methods in this class require [user authentication](AdminAuthResource.mdx#createsession). Regions are different countries or geographical regions that the commerce store serves customers in. Admins can manage these regions, their providers, and more. Related Guide: [How to manage regions](https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-regions). ## Methods ### addCountry Add a country to the list of countries in a region. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .addCountry(regionId, { country_code: "dk", }) .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### addFulfillmentProvider Add a fulfillment provider to the list of fulfullment providers in a region. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .addFulfillmentProvider(regionId, { provider_id: "manual", }) .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### addPaymentProvider Add a payment provider to the list of payment providers in a region. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .addPaymentProvider(regionId, { provider_id: "manual", }) .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### create Create a region. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .create({ name: "Europe", currency_code: "eur", tax_rate: 0, payment_providers: ["manual"], fulfillment_providers: ["manual"], countries: ["DK"], }) .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "The name of the Region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "`string`[]", "description": "A list of Payment Provider IDs that can be used in the Region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code of the Region.", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate to use in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] }, { "name": "customHeaders", "type": "`Record`", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### delete Delete a region. Associated resources, such as providers or currencies are not deleted. Associated tax rates are deleted. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions.delete(regionId).then(({ id, object, deleted }) => { console.log(id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns ___ ### deleteCountry Delete a country from the list of countries in a region. The country will still be available in the system, and it can be used in other regions. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions.deleteCountry(regionId, "dk").then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### deleteFulfillmentProvider Delete a fulfillment provider from a region. The fulfillment provider will still be available for usage in other regions. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .deleteFulfillmentProvider(regionId, "manual") .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### deletePaymentProvider Delete a payment provider from a region. The payment provider will still be available for usage in other regions. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .deletePaymentProvider(regionId, "manual") .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### list Retrieve a list of Regions. The regions can be filtered by fields such as `created_at` passed in the `query` parameter. The regions can also be paginated. #### Example To list regions: ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions.list().then(({ regions, limit, offset, count }) => { console.log(regions.length) }) ``` By default, only the first `50` records are retrieved. You can control pagination by specifying the `limit` and `offset` properties: ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .list({ limit, offset, }) .then(({ regions, limit, offset, count }) => { console.log(regions.length) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### retrieve Retrieve a region's details. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions.retrieve(regionId).then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} /> ___ ### retrieveFulfillmentOptions Retrieve a list of fulfillment options available in a region. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .retrieveFulfillmentOptions(regionId) .then(({ fulfillment_options }) => { console.log(fulfillment_options.length) }) ``` #### Parameters `", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns ___ ### update Update a region's details. #### Example ```ts import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.regions .update(regionId, { name: "Europe", }) .then(({ region }) => { console.log(region.id) }) ``` #### Parameters `", "description": "", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "The name of the Region", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "`string`[]", "description": "A list of Payment Provider IDs that can be used in the Region", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code of the Region.", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider to use. If none provided, the system tax provider is used.", "optional": true, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate to use in the Region.", "optional": true, "defaultValue": "", "expandable": false, "children": [] } ] }, { "name": "customHeaders", "type": "`Record`", "description": "Custom headers to attach to the request.", "optional": false, "defaultValue": "{}", "expandable": false, "children": [] } ]} /> #### Returns `", "description": "An optional key-value map with additional details", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "name", "type": "`string`", "description": "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.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "payment_providers", "type": "[PaymentProvider](../internal/classes/internal.PaymentProvider.mdx)[]", "description": "The details of the payment providers that can be used to process payments in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_code", "type": "`string`", "description": "The tax code used on purchases in the Region. This may be used by other systems for accounting purposes.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_provider", "type": "[TaxProvider](../internal/classes/internal.TaxProvider.mdx)", "description": "The details of the tax provider used in the region.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "tax_provider_id", "type": "``null`` \\| `string`", "description": "The ID of the tax provider used in this region", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rate", "type": "`number`", "description": "The tax rate that should be charged on purchases in the Region.", "optional": false, "defaultValue": "", "expandable": false, "children": [] }, { "name": "tax_rates", "type": "``null`` \\| [TaxRate](../internal/classes/internal.TaxRate.mdx)[]", "description": "The details of the tax rates used in the region, aside from the default rate.", "optional": false, "defaultValue": "", "expandable": true, "children": [] }, { "name": "updated_at", "type": "`Date`", "description": "The date with timezone at which the resource was updated.", "optional": false, "defaultValue": "", "expandable": false, "children": [] } ] } ] } ] } ]} />