Documents, items, accounts, and Israeli tax‑authority certification — one JSON API. This portal pairs the full reference with guided journeys for the integrations people actually build first.
Authorization: Bearer <token> and login-company.
These identify you and the Linet company you're operating on.
The token comes from the API key created in Linet (user settings → Api Keys) — see the
company & setup journey if you're
wondering where a company comes from in the first place.
The token is shown once, when the key is created: Linet keeps only a
one‑way hash of it, so a lost token means revoking the key and creating
a new one.
login-id and login-hash headers; that still works.
curl -X POST https://app.linet.org.il/api/newsearch/item \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' -H 'login-company: <company id>' \
-d '{"limit": 10, "offset": 0}'
Every response is {"status", "text", "body", "errorCode"},
and errors usually come back as HTTP 200 — check
status and errorCode in the body, not just the
HTTP code. The reference overview has
the full table.
GET /api/v2/items/12887), real HTTP status codes, clean field
names, cursor paging, filters such as issue_date[gte]=2026-09-01, keys that can be
limited to read-only, and retry-safe creates with Idempotency-Key. It uses the
same API keys and ids as today. v2 is not live yet: read the v2
reference to see what is coming, and how to move from v1.
Add a new item to the catalog, search for it by SKU before touching it again, then apply a partial update — the safe read‑before‑write pattern for every catalog sync.
Start journey DocumentsIssue an invoice, receipt, or invoice‑receipt: how doctype, line items (docDet) and payment lines (docCheq) fit together, with real payloads for cash, cheque, credit card and bank transfer.
Start journey SetupWhere login-company comes from: how a
Linet company is provisioned, what gets configured on day one, and
what to hand your integration once it's ready.
Authorize against the Israeli Tax Authority's allocation‑number API, store the certificate, and get a confirmation number stamped onto a real document.
Start journey WebhooksThe payload shape Linet publishes to when an Item, Item
Category, Account or Document changes — envelope fields,
changedAttributes, and real example
notifications.
The linet.print/1 template: layers, blocks, fields and
bindings, and reading and writing it through API v2.
Mail and SMS templates for documents and service calls: which one is used, the placeholders and their filters, and the API to read, write and preview them.
Start journey Service callsOpen service calls, record parts and time, close them, and follow every change by webhook (Service module).
Start journey AutomationsTriggers, conditions and actions: send a mail or SMS, call a webhook or update a field when a record changes. Try it on a record first, then read its run log.
Start journey