REST API · v1

Wire Baslic into your stack.

Forward a receipt, classify VAT per-line, validate VIES, and push clean entries to bookkeeping — all programmatically. Auth is a single Bearer token. Everything is JSON.

5-minute quick start

Send your first receipt in one cURL.

Get an API key from your workspace settings, point cURL at the receipts endpoint, and we'll return a parsed JSON with per-line VAT, classifications, and ruleIds.

Get an API key Read the docs

upload-receipt.sh

bash

# Upload a Z-report and get per-line VAT back
curl -X POST https://api.baslic.com/v1/receipts \
  -H "Authorization: Bearer $BASLIC_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/z-report.pdf" \
  -F "workspace=fidanet"

# 200 OK · ~1.4s · returns parsed + classified
{
  "id": "rcp_a1b2c3",
  "vendor": "Ravintola Linnea",
  "lines": [
    {"item": "Food", "vat": "13.5%", "ruleId": "vat-fi-food"},
    {"item": "Beer", "vat": "25.5%", "ruleId": "vat-fi-alcohol"}
  ]
}

Endpoints

Six endpoints. That's usually all you need.

POST/v1/receipts

Upload a receipt

Accepts JPG, PNG, PDF, HEIC. Returns parsed line items + Timo's per-line VAT classification with ruleIds.

Reference

POST/v1/invoices

Record an outgoing invoice

Auto-detects reverse-charge and 0% export based on customer VAT ID. Stores VIES proof when applicable.

Reference

GET/v1/classify

Classify text without uploading

Pass receipt text or invoice description, get the VAT bracket and ruleId back. Useful for previewing.

Reference

GET/v1/vies/:vatId

Live VIES validation

Hits the EU VIES registry, returns company name + address + a verified-at timestamp. Cached 24h.

Reference

POST/v1/exports

Push to bookkeeping

Triggers an export to Procountor, Netvisor, e-conomic, Fortnox, or universal CSV/SAF-T.

Reference

GET/v1/clients

List clients (accountant)

Returns every client in your accountant cockpit with kanban state and last-export timestamp.

Reference

Auth

Bearer token

Per-workspace API keys, rotatable any time. Scoped to read, write, or admin.

Webhooks

Push events

receipt.parsed, classification.flagged, export.completed — signed with HMAC-SHA256.

Rate limits

60 / min · 5K / day

Higher limits available on Business Pro and custom Accountant plans. Soft retries with backoff.

SDKs

Use the SDK for your stack — or just cURL.

TypeScript

Node

@baslic/sdk

Python 3.10+

Python

baslic

Go 1.22+

github.com/baslic/baslic-go

no SDK needed

cURL

any HTTP client

Webhook payload

Receipt parsed → your endpoint.

Subscribe to events from your workspace settings. We retry with exponential backoff for 24 hours and surface failures in your dashboard.

Signed with X-Baslic-Signature

receipt.parsed

json

{
  "event": "receipt.parsed",
  "workspace": "fidanet",
  "data": {
    "id": "rcp_a1b2c3",
    "vendor": "Bauhaus AG",
    "country": "DE",
    "reverseCharge": true,
    "viesVerified": true,
    "viesVerifiedAt": "2026-05-17T10:42:18Z",
    "amount": { "net": 1204.12, "vat": 0, "currency": "EUR" },
    "ruleIds": ["vat-fi-rc-eu-b2b"]
  },
  "created": "2026-05-17T10:42:21Z"
}

Get an API key, ship in an afternoon.

API is included on every paid plan. Free plan has read-only access — enough to test the integration.

Get an API key Talk to engineering