API Introduction

Learn how to integrate with the Curosa API v1 to manage products, orders, and inventory programmatically.

Welcome to the Curosa API v1

The Curosa API allows you to programmatically manage your supplier account, products, orders, and inventory. Our REST API uses standard HTTP methods and returns JSON responses.

Base URL

All API requests should be made to:

https://api.curosa.com/v1

Authentication

The Curosa API uses API keys for authentication. You can generate API keys from your supplier dashboard under Settings → API Keys.

Include your API key in the Authorization header:

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

Response Format

All responses are returned in JSON format:

{
  "data": {
    "id": "prod_123",
    "name": "Example Product",
    "sku": "EX-001"
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Error Handling

When an error occurs, the API returns an appropriate HTTP status code and error details:

Status Code	Description
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Insufficient permissions
`404`	Not Found - Resource doesn't exist
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error

Error response format:

{
  "error": {
    "code": "invalid_parameter",
    "message": "The 'sku' field is required",
    "field": "sku"
  }
}

Pagination

List endpoints support pagination using page and per_page query parameters:

GET /v1/products?page=2&per_page=25

Paginated responses include metadata:

{
  "data": [...],
  "meta": {
    "current_page": 2,
    "per_page": 25,
    "total": 150,
    "total_pages": 6
  }
}

Next Steps

Authentication - Learn about API key management and scopes
Rate Limiting - Understand rate limits and best practices
Products - Manage your product catalog