GET Feedback KSeF Sales Invoices

Feedback data and files

GET List of Incoming Invoices

EndpointMethodResponse
/v1/ordersGETGet Full list of orders
/v1/orders/999999GETGet data of 1 order

How to Access the Returned Files

What KSeF specific information is available in the returned API Json body:

Type of InformationWhat
PDF fileThe PDF generated by Billit and enriched with KSeF signature information
Json fileThe Json file that has been posted to Billit
Messages sectionStatus info and KSeF XML
Signature sectionKSeF Signature Information including KSeF signature File

About the files that can be retrieved:

Type of InformationWhatAction API endpoint
PDF fileThe PDF generated by Billit and enriched with KSeF signature informationGet v1/files
Json fileThe Json file that has been posted to BillitGet v1/files
Messages sectionStatus info and KSeF XMLGet v1/files
Signature sectionKSeF Signature Information including KSeF signature FileGet v1/order

Instruction how to get a File :

EndpointMethodVariable
Files : /v1/files/33ae4e0b-a579-46c3-b0d0-839999bb4ac1GETInclude FileID

Examples about the files:

    "OrderPDF": {
        "FileID": "33ae4e0b-a579-46c3-b0d0-839999bb4ac1",
        "FileName": "Invoice_409859_2_CentralneLaboratoriumPomiarowoBa.pdf"
    },
    "Attachments": [
        {
            "FileID": "1d28180f-ed23-4e0d-b2c0-4c4d4af9999e",
            "FileName": "409859_2__23_01_2026 8_50_46.json"
        }
    ],
"Messages": [
        {
            "Description": "9540010231-20260123-010040EC0636-5A",
            "FileID": "6ef998f0-a5ec-425b-bc5f-d99bbd9c99", //File ID of the XML file
            "CreationDate": "2026-01-23T08:51:01.227",
            "TransportType": "KSeF",
            "Success": true,
            "Trials": 2,
            "Destination": "PL6331975945",
            "MessageDirection": "Outgoing"
        }
    ],
"QRCode": "iVBORw0......5ErkJggg==",

Example of Returned Information : Messages Segment

PropertySignificationSample value(s)
DescriptionKSeF ID9540010231-20260123-010040EC9999-9A
FileIDBillit ID of the file (for GET V1/files)6ef998f0-a5ec-425b-bc5f-d5757bbd9c99
CreationDateDate of creation at KSeF2026-01-23T08:51:01.227
TransportTypeWhen sent to KSeF then value is KSeFKSeF
SuccessResult returned by KSef, if false corrective action is neededtrue, false
TrialsNumber of attempts by Billit2
DestinationID of destination (typically VAT Numer or NIP number)PL6331975999
MessageDirectionOutgoing for Sales Invoices (Income)Outgoing

Sample content:

    "Messages": [
        {
            "Description": "9540010231-20260123-010040EC9999-9A",
            "FileID": "6ef998f0-a5ec-425b-bc5f-d5757bbd9c99",
            "CreationDate": "2026-01-23T08:51:01.227",
            "TransportType": "KSeF",
            "Success": true,
            "Trials": 2,
            "Destination": "PL6331975999",
            "MessageDirection": "Outgoing"
        }
    ],

Example of Returned Information : Signature

In the Json a Signature segment is present.

DocumentStampKSeF ID
DateTimeInfoDate of creation at KSeF
QRCodeFile with the QR code
StampUrlLink to KSeF allowing to performn a manual validation

Sample content:

"Signature": {
        "DocumentStamp": "9540010231-20260123-010040EC9999-9A",
        "DateTimeInfo": {
            "DateTime": "2026-01-23T08:52:05.7304125+01:00"
        },
        "QRCode": "iVBORw0KGgoAAAAt2iqF1F..........IaVulUnRe3+iehvq1bqtnaibErkJggg==",
        "StampUrl": "https://qr-test.ksef.mf.gov.pl/client-app/invoice/9540010231/23-01-2026/EpJeQd5vAOUroMnYiN67eI6Z2I8AmOsgIzojUx5t3pc"
    }