​
Base URL

All API requests should be made to: 
https://receeco.com/api/trpc

​
Request Format

Receeco uses tRPC for type-safe API communication. All requests use JSON format with the following structure: 
{
  "input": {
    // Your request parameters here
  }
}

​
Response Format

All successful responses follow this structure: 
{
  "result": {
    "data": {
      // Response data here
    }
  }
}

​
Error Handling

Errors are returned with descriptive messages and appropriate HTTP status codes: 
{
  "error": {
    "message": "Receipt not found",
    "code": -32603,
    "data": {
      "code": "NOT_FOUND",
      "httpStatus": 404,
      "path": "getReceipt"
    }
  }
}

​
Common Error Codes

CodeDescriptionHTTP Status
INVALID_INPUTRequest validation failed400
NOT_FOUNDResource not found404
UNAUTHORIZEDAuthentication required401
FORBIDDENInsufficient permissions403
INTERNAL_SERVER_ERRORServer error500

​
Rate Limits

  • Public endpoints: No rate limits
  • Authenticated endpoints: 1000 requests/minute
  • Burst limit: 100 requests in 10 seconds

​
SDKs

Node.js

Official TypeScript SDK

Python

Python client library

PHP

PHP integration library

​
Endpoints Overview

POS Integration

Create and manage receipts from POS systems

Customer Access

Customer receipt retrieval and management