REST API

Billy dati jūsu programmai

Izrakstiet rēķinu melnrakstus no e-veikala vai CRM, lasiet klientus, saņemtos rēķinus un bankas darījumus, pārbaudiet uzņēmumus Uzņēmumu reģistrā. JSON, viena atslēga, skaidras kļūdas.

Atvērt API references OpenAPI 3.1

Sāciet 3 soļos

Izveidojiet atslēgu

Billy → Iestatījumi → API un AI asistenti → „Izveidot atslēgu”. Izvēlieties „Tikai lasīt” vai „Lasīt un veidot”. Atslēgu redzēsiet tikai vienreiz — saglabājiet to drošā vietā.

Atvērt Billy

Pirmais pieprasījums

Atslēga iet galvenē Authorization: Bearer. Kopsavilkums atgriež naudas atlikumu, debitorus, kreditorus un mēneša apgrozījumu.

curl https://billy.lv/api/v1/summary \
  -H "Authorization: Bearer billy_sk_…"

Izrakstiet rēķina melnrakstu

Numuru, rekvizītus, bankas kontu un apmaksas termiņu Billy aizpilda pats; summas aprēķina pēc rindām (PVN noklusējumā 21 %). Melnrakstu pārbaudiet un nosūtiet Billy — API rēķinus nesūta.

curl -X POST https://billy.lv/api/v1/invoices \
  -H "Authorization: Bearer billy_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "40003032949",
    "lines": [
      { "description": "Konsultācija", "quantity": 10, "unit": "h", "unitPrice": 45 }
    ]
  }'

{
  "id": "05a39c68-…",
  "invoiceNumber": "INV-2026-0042",
  "status": "Draft",
  "issueDate": "2026-10-23",
  "dueDate": "2026-11-06",
  "recipient": { "name": "AS \"Latvenergo\"", "registrationNumber": "40003032949", … },
  "subtotal": 450,
  "totalTax": 94.5,
  "totalAmount": 544.5,
  "url": "https://billy.lv/dashboard/invoices/outgoing/05a39c68-…",
  "lines": [ … ]
}

201

Endpointi

Bāzes adrese https://billy.lv/api/v1. Parametri, shēmas un pieprasījumu izmēģināšana — API referencēs.

Uzņēmums
GET	/company	Uzņēmuma rekvizīti
GET	/summary	Finanšu kopsavilkums
Klienti
GET	/clients	Klienti
GET	/clients/{id}	Klients
POST	/clients	Pievienot klientu
Produkti
GET	/products	Produkti un pakalpojumi
Rēķini
GET	/invoices	Izrakstītie rēķini
GET	/invoices/{id}	Rēķins
POST	/invoices	Izveidot rēķina melnrakstu
Saņemtie rēķini
GET	/incoming-invoices	Saņemtie rēķini
Banka
GET	/bank/transactions	Bankas darījumi
Uzņēmumu reģistrs
GET	/register/companies	Meklēt Uzņēmumu reģistrā
GET	/register/companies/{registrationNumber}	Pārbaudīt uzņēmumu

Noteikumi

Summas ir skaitļi (eiro vai rēķina valūtā), datumi GGGG-MM-DD.
Saraksti: limit (līdz 200) un offset; atbildē total.
Rēķinu un klientu var norādīt ar ID vai cilvēcīgi: rēķina numuru, reģistrācijas numuru.
Atslēga pieder vienam uzņēmumam. „Tikai lasīt” atslēga uz POST saņem 403 insufficient_scope.
CORS atļauts — var saukt arī no pārlūka, bet atslēgu publiskā lapā nelieciet.

Kļūdas

Vienmēr vienā formā, ar HTTP statusu 400, 401, 403, 404 vai 422:

{
  "error": {
    "code": "validation_error",
    "message": "Nederīgi ievaddati",
    "details": [{ "path": "lines", "message": "…" }]
  }
}

Lietotne, kas strādā lietotāja vārdā? OAuth 2.1

Ja jūsu lietotne pieslēdz Billy citiem lietotājiem, izmantojiet OAuth, nevis viņu atslēgas: issuer https://billy.lv/auth, metadati /.well-known/oauth-authorization-server/auth, dinamiskā klientu reģistrācija, PKCE, tiesības billy:read un billy:write, parametrs resource=https://billy.lv/api/v1. Lietotājs pieslēdzoties izvēlas uzņēmumu.

Gribat vienkārši pajautāt AI?

Tie paši rīki pieejami Claude, ChatGPT un Gemini kā MCP serveris — bez koda.

AI asistenti (MCP) Izmēģināt Billy