Distribution Centres

Retrieve a list of available distribution centres where you can store and fulfil your products

Overview

The Distribution Centres endpoint returns all distribution centres available to your supplier account. Each distribution centre is associated with a specific site and describes its operational capabilities. Distribution centre codes are referenced throughout the API when working with inventory and stock updates.

Authentication

This endpoint requires authentication. Include your API token in the Authorization header. For more information on obtaining a token, see the Authentication guide.

List All Distribution Centres

Retrieve a list of all distribution centres available to your account.

Endpoint: GET https://curosa.com/api/v1/distribution-centres

Request

curl --location 'https://curosa.com/api/v1/distribution-centres' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Response

Returns a 200 OK with a data array containing all distribution centres:

{
    "data": [
        {
            "code": "DEMO-DC",
            "name": "Demo Distribution Centre",
            "site": {
                "code": "UK",
                "name": "United Kingdom"
            },
            "is_supplier_dc": true,
            "is_fulfillment_centre": true,
            "is_warehouse": true,
            "is_active": true,
            "leadtime_days": 0,
            "cutoff_time": "17:00:00"
        }
    ]
}

Response Fields:

Field	Type	Description
`code`	string	Unique identifier for the distribution centre. Used as a reference in other API calls
`name`	string	Display name of the distribution centre
`site`	object	The site this distribution centre belongs to
`site.code`	string	Site identifier (e.g. `"UK"`)
`site.name`	string	Site display name (e.g. `"United Kingdom"`)
`is_supplier_dc`	boolean	Whether this is a supplier-managed distribution centre
`is_fulfillment_centre`	boolean	Whether this centre can fulfil customer orders
`is_warehouse`	boolean	Whether this centre can hold inventory
`is_active`	boolean	Whether this distribution centre is currently operational
`leadtime_days`	integer	Number of days required for processing before dispatch
`cutoff_time`	string	Daily order cutoff time after which orders are processed the next day (format: `"HH:MM:SS"`)

Using Distribution Centre Codes

The code value is used when referencing a distribution centre in other API calls, such as when setting stock levels on a product:

{
    "distribution_centre_stock": [
        {
            "distribution_centre_code": "DEMO-DC",
            "stock_quantity": 50
        }
    ]
}

Rate Limiting

This endpoint is rate limited to 3,600 requests per hour. The current limit and remaining requests are returned in the response headers as x-ratelimit-limit and x-ratelimit-remaining.