Distribution Centers

Overview

The Distribution Centres endpoint allows you to retrieve a list of all available distribution centres (warehouses and fulfillment centers) where you can store inventory and fulfill orders through the Curosa platform. Each distribution centre is associated with a specific site and has various capabilities and operational parameters.

Authentication

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

List All Distribution Centres

Retrieve a list of all available distribution centres.

Request

curl -X GET "https://api.curosa.com/v1/distribution-centres" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

All responses are returned in JSON format:

{
    "data": [
        {
            "code": "ABC",
            "name": "ABC Warehouse (England)",
            "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:

• code (string): A unique identifier code for the distribution centre
• name (string): The display name of the distribution centre
• site (object): The associated site information
  • code (string): The site code (e.g., "UK")
  • name (string): The site name (e.g., "United Kingdom")
• is_supplier_dc (boolean): Whether this is a supplier-owned distribution centre
• is_fulfillment_centre (boolean): Whether this centre can fulfill orders
• is_warehouse (boolean): Whether this centre functions as a warehouse, storing products for distribution.
• is_active (boolean): Whether this distribution centre is currently active
• leadtime_days (integer): The number of days required for processing before shipment
• cutoff_time (string): The daily cutoff time for orders (format: "HH:MM:SS")

Using Distribution Centre Codes

When creating or updating resources that require a distribution centre reference (such as inventory allocations or shipment routing), use the code parameter from the distribution centre object in your request payload. The distribution centre code is required for operations that specify where inventory is stored or where orders should be fulfilled from.