Skip to main content

Overview

The Recepta API is a REST API that lets you integrate Recepta into your own applications, CRMs, AI agents, and automation workflows. Base URL: https://api.recepta.ai/api/v1

Authentication

All endpoints require an API key in the x-api-key header:
x-api-key: rcp_your_api_key_here
Create and manage API keys in Settings > API Keys in the Recepta dashboard.

Rate Limits

PlanRequests / Minute
Free30
Starter60
Growth300
Enterprise1,000
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Exceeding the limit returns 429 Too Many Requests with a Retry-After header.

Errors

All errors use this format:
{
  "success": false,
  "message": "Human-readable error description"
}
CodeMeaning
400Bad Request — invalid or missing parameters
401Unauthorized — invalid or missing API key
403Forbidden — API key lacks required permission
404Not Found — resource does not exist
429Rate Limited — too many requests
500Server Error — try again later