Sites

Overview

The Sites endpoint allows you to retrieve a list of all available sites (markets/regions) where you can sell your products through the Curosa platform. Each site represents a different geographic market or sales channel.

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 Sites

Retrieve a list of all available sites.

Request

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

Response

All responses are returned in JSON format:

{
    "data": [
        {
            "code": "UK",
            "name": "United Kingdom"
        },
        {
            "code": "US",
            "name": "United States"
        }
    ]
}

Response Fields:

• code (string): A unique identifier code for the site (e.g., "UK", "US")
• name (string): The display name of the site (e.g., "United Kingdom", "United States")

Using Site Codes

When creating or updating resources that require a site reference (such as products, pricing, or inventory), use the code parameter from the site object in your request payload. The site code is a required field for operations that are site-specific.