Get KSeF status

Where an invoice stands in KSeF: not sent, processing, accepted or an error.

GET https://cotlet.dev/api/v1/fakturownia/invoices/{invoice_id}/ksef-status

read

Returns gov_status, the KSeF number once there is one, the send date and error messages for one invoice. Statuses include ok, processing, send_error, server_error, offline and not_connected. A null status means the invoice was not sent.

Parameters

Parameters: get_ksef_status
NameTypeDescription
invoice_id integer required integer Invoice ID from list_invoices.

Request

cURL
curl https://cotlet.dev/api/v1/fakturownia/invoices/1/ksef-status \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("fakturownia", "get_ksef_status", {"invoice_id":1})
Node.js
const result = await cotlet.call('fakturownia', 'get_ksef_status', {"invoice_id":1});
CLI
cotlet call fakturownia get_ksef_status --data '{"invoice_id":1}'

Example response

JSON

{
  "invoice_id": 5120,
  "gov_status": "ok",
  "gov_id": "1234563218-20261014-A1B2C3D4E5F6",
  "gov_send_date": "2026-10-14T10:30:00+02:00",
  "gov_error_messages": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.