Developers

Business API

Pull your receipts into accounting or ERP systems, or send files to be scanned. Create keys on the API page after signing in.

Authentication

Send your key as Authorization: Bearer <key> or X-Api-Key: <key>. Keys belong to a workspace and have permissions: receipts:read and receipts:write. Limit: 600 requests per hour per key.

Endpoints

Request	What it does
GET /api/v1/receipts	List receipts. Filters: from, to (YYYY-MM-DD), q, updated_since (ISO 8601, for incremental sync), page, per_page (max 100).
GET /api/v1/receipts/{uuid}	One receipt with its items (also ?uuid=).
GET /api/v1/export?format=csv|xlsx|pdf	Download a file, same filters.
POST /api/v1/batches	Upload up to 50 files as files[] to scan (needs receipts:write; uses tokens).
GET /api/v1/batches/{uuid}	Scan progress.

Example

curl -H "Authorization: Bearer rai_live_…" "https://tafity.com/api/v1/receipts?from=2026-09-01&per_page=50"

Responses look like {"success": true, "message": "OK", "receipts": [...]}; errors like {"success": false, "error": "…"}. Amounts are decimals in the receipt's currency.

Questions? support@tafity.com