Docs/Quickstart
Getting Started

Quickstart

Make your first API call in under 5 minutes. No SDK required — just HTTP.

1

Create a free account

Go to receiptconverter.com/login and sign up for a free account. No credit card required. Free accounts include 10 conversions/month.

2

Generate an API key

Go to your dashboard, scroll to the API Keys section, and click + Generate key. Give it a name and click Create.

The full key is shown only once — copy it and store it securely. It starts with sk_live_.

3

Make your first request

Replace sk_live_your_key_here and receipt.jpg with your own values:

curl -X POST https://receiptconverter.com/api/v1/convert \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -F "file=@receipt.jpg"

No receipt handy? Use a URL instead:

curl -X POST https://receiptconverter.com/api/v1/convert \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/400px-Camponotus_flavomarginatus_ant.jpg"}'
4

Parse the response

A successful response looks like this:

{
  "success": true,
  "processing_ms": 1240,
  "conversions_used": 1,
  "conversions_limit": 10,
  "data": {
    "vendor": "Starbucks",
    "date": "2024-03-15",
    "total": 12.50,
    "subtotal": 11.75,
    "currency": "USD",
    "payment_method": "Visa ****4242",
    "category": "Food & Drink",
    "taxes": [{ "label": "Sales Tax", "amount": 0.75 }],
    "tip": null,
    "items": [
      { "name": "Latte",    "quantity": 1, "unit_price": 6.50, "total_price": 6.50 },
      { "name": "Muffin",   "quantity": 1, "unit_price": 3.25, "total_price": 3.25 }
    ]
  }
}