Sites - Curosa

Overview

The Sites endpoint returns all sites (markets/regions) that are available to your supplier account. Each site represents a distinct geographic market on the Curosa platform. Site codes are referenced throughout the API when working with products, pricing, and inventory.

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 Sites

Retrieve a list of all sites available to your account.

Endpoint: GET https://curosa.com/api/v1/sites

Request

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

Response

Returns a 200 OK with a data array containing all sites available to your account:

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

Response Fields:

Field	Type	Description
`code`	string	Unique identifier for the site. Used as a reference in other API calls (e.g. `"UK"`)
`name`	string	Display name of the site (e.g. `"United Kingdom"`)

Using Site Codes

The code value from the site object is used as a reference throughout the API. For example, when setting pricing on a product you will reference the site using site_code:

{
    "site_pricing": [
        {
            "site_code": "UK",
            "price": "50.00",
            "price_currency": "GBP"
        }
    ]
}

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.