Introduction

Welcome to the Curyloop API documentation. The API allows you to programmatically interact with Curyloop to manage groups, sessions, items, and more.

Base URL

All API requests are made to:

https://curyloop.com/api

Authentication

The Curyloop API uses Bearer token authentication. Include your API key in the Authorization header of every request:

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

You can generate API keys from your Settings > API Keys page.

Response Format

All responses are returned in JSON format:

{
  "data": { ... },
  "error": null
}

Error responses follow the same structure:

{
  "data": null,
  "error": "Unauthorized"
}

Rate Limits

When you exceed the rate limit, the API returns a 429 Too Many Requests status code.

HTTP Status Codes