REST API & MCP

API Documentation

Everything you need to integrate CuryLoop into your workflows. Authenticate with API keys, manage groups and sessions, and connect via MCP for AI-powered access.

Get started with the CuryLoop API. Learn how to authenticate, make requests, and integrate CuryLoop into your workflows.

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:

bash
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:

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

Error responses follow the same structure:

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

Rate Limits

PlanRequests / minute
Free60
Pro300

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

HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Internal Server Error