Talero REST API

Integrer dit system med Talero. 44 endpoints til fakturaer, kunder, produkter, udgifter, leverandører, konti, posteringer, rapporter og webhooks.

REST + JSON
API Key Auth
Rate Limiting
Webhooks
Idempotency
OpenAPI 3.1
Kom i gang

Fire trin til din første integration

Det tager under 5 minutter at komme i gang med Talero API.

1 Generer en API-nøgle

Gå til Indstillinger → API-nøgler i din Talero-konto, og opret en ny nøgle med de scopes du har brug for.

tlr_live_a1b2c3d4e5f6…

2 Send din første request

Brug X-API-Key-headeren til at autentificere dine requests.

curl -H "X-API-Key: tlr_live_…" \ https://app.talero.dk/api/v1/invoices

3 Opret data

Brug POST-endpoints til at oprette fakturaer, kunder, produkter osv. Tilføj en Idempotency-Key for at undgå duplikater.

POST /api/v1/invoices Idempotency-Key: order-12345 Content-Type: application/json

4 Opsæt webhooks

Abonnér på events og modtag realtime-notifikationer, når der sker ændringer i systemet.

POST /api/v1/webhooks { "url": "https://dit-system.dk/hook", "events": ["invoice.created"] }
Autentificering

Sikkerhed der følger best practices

Granulære scopes, rate limiting, og idempotency — alt hvad moderne integrationer kræver.

🔑 API Key Auth

Hashed keys med tlr_live_ prefix. Nøglen vises kun én gang — gem den sikkert.

X-API-Key: tlr_live_a1b2c3d4…

🛡️ 19 granulære scopes

Giv kun adgang til det, der er nødvendigt. Hver nøgle kan have sine egne tilladelser.

invoices:read, invoices:write customers:read, customers:write products:read, products:write webhooks:manage, exports:read…

🚦 Rate Limiting

Alle responses indeholder headers, der viser dit forbrug og grænser.

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 97 X-RateLimit-Reset: 58
Reference

Alle 44 endpoints

Komplet oversigt over alle tilgængelige API-endpoints. Base URL: https://app.talero.dk/api/v1

Metode Endpoint Beskrivelse Scope
Meta
GET/openapi.jsonOpenAPI 3.1 specifikationingen
Fakturaer
GET/invoicesList fakturaer (filtrér, søg, sortér)invoices:read
POST/invoicesOpret faktura (idempotent)invoices:write
GET/invoices/{id}Hent faktura + linjerinvoices:read
PUT/invoices/{id}Opdater kladde-fakturainvoices:write
DEL/invoices/{id}Slet kladde-fakturainvoices:write
PUT/invoices/{id}/statusOpdater status (draft→approved→sent→paid)invoices:write
Kunder
GET/customersList kundercustomers:read
POST/customersOpret kunde (idempotent)customers:write
GET/customers/lookupSlå op via CVR, email eller telefoncustomers:read
GET/customers/{id}Hent kundecustomers:read
PUT/customers/{id}Opdater kundecustomers:write
DEL/customers/{id}Slet kunde (blokeret ved fakturaer)customers:write
Produkter
GET/productsList produkterproducts:read
POST/productsOpret produkt (idempotent)products:write
GET/products/{id}Hent produktproducts:read
PUT/products/{id}Opdater produkt (partial)products:write
DEL/products/{id}Slet produktproducts:write
Udgifter
GET/expensesList udgifterexpenses:read
POST/expensesOpret udgift (idempotent)expenses:write
GET/expenses/{id}Hent udgiftexpenses:read
PUT/expenses/{id}Opdater udgiftexpenses:write
DEL/expenses/{id}Slet udgiftexpenses:write
Leverandører
GET/suppliersList leverandørersuppliers:read
POST/suppliersOpret leverandør (idempotent)suppliers:write
GET/suppliers/{id}Hent leverandørsuppliers:read
PUT/suppliers/{id}Opdater leverandørsuppliers:write
DEL/suppliers/{id}Slet leverandørsuppliers:write
Konti
GET/accountsList kontiaccounts:read
POST/accountsOpret konto (idempotent)accounts:write
PUT/accounts/{id}Opdater konto (blokeret for systemkonti)accounts:write
Posteringer
GET/transactionsList posteringertransactions:read
POST/transactionsOpret postering (validerer debet=kredit)transactions:write
Rapporter
GET/reports/balanceBalance (status)reports:read
GET/reports/profit-lossResultatopgørelsereports:read
Eksport
GET/exports/saftSAF-T XML eksportexports:read
Webhooks
GET/webhooksList webhook-abonnementerwebhooks:manage
POST/webhooksOpret webhook (kun HTTPS)webhooks:manage
DEL/webhooks/{id}Slet webhookwebhooks:manage
Webhooks

20 events du kan abonnere på

Modtag realtime-notifikationer, når data ændres i Talero. Alle payloads er JSON og signeret med din hemmelighed.

📄 Fakturaer

invoice.created invoice.updated invoice.deleted invoice.approved invoice.sent invoice.paid invoice.cancelled

👥 Kunder

customer.created customer.updated customer.deleted

📦 Produkter

product.created product.updated product.deleted

💰 Mere

expense.created/updated/deleted supplier.created/updated/deleted transaction.created

Klar til at bygge din
integration?

Opret en gratis konto, generer din API-nøgle, og send din første request på under 5 minutter.

Opret gratis konto → Download OpenAPI Spec