List KSeF purchase invoices

Invoices that suppliers sent to you in KSeF and you have not booked yet.

GET https://cotlet.dev/api/v1/ifirma/ksef-purchase-invoices

read

Downloads new purchase invoices from KSeF into the "Faktury z KSeF" list and returns them. Each item has the seller document number, KSeF number, document type, seller NIP, issue date, and net and gross amounts. The date is the seller issue date, not the date sent to KSeF. Documents already booked are not returned.

Parameters

Parameters: list_ksef_purchase_invoices
NameTypeDescription
issued_from string required string YYYY-MM-DD, the first seller issue date to download.

Request

cURL
curl "https://cotlet.dev/api/v1/ifirma/ksef-purchase-invoices?issued_from=issued+from" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("ifirma", "list_ksef_purchase_invoices", {"issued_from":"issued from"})
Node.js
const result = await cotlet.call('ifirma', 'list_ksef_purchase_invoices', {"issued_from":"issued from"});
CLI
cotlet call ifirma list_ksef_purchase_invoices --data '{"issued_from":"issued from"}'

Example response

JSON

{
  "invoices": [
    {
      "ksef_number": "7010003987-20261012-AB12CD34EF56-7A",
      "seller_number": "FV 118/2026",
      "type": "vat",
      "seller_nip": "7010003987",
      "issue_date": "2026-10-12",
      "net": 650.41,
      "gross": 800
    },
    {
      "ksef_number": "5252248481-20261010-9F8E7D6C5B4A-12",
      "seller_number": "ZAL 7/2026",
      "type": "advance",
      "seller_nip": "5252248481",
      "issue_date": "2026-10-10",
      "net": 2000,
      "gross": 2460
    }
  ]
}

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.