---
title: "List self-billed e-invoices"
method: GET
path: "/v1/einvoicing/self-billed-einvoices"
tags: ["v1 - EInvoicing"]
---

# List self-billed e-invoices

`GET /v1/einvoicing/self-billed-einvoices`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/einvoicing/self-billed-einvoices`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Returns a paginated list of the self-billed e-invoices of the company, newest first

## Query parameters

- `sort` string: Sort string in the format `field:direction`. To provide multiple sort fields, separate them with commas. Available directions: `asc`, `desc`. Available fields: `createdAt`.
- `filter` string: Filter string in the format `field:operator:value`. To provide multiple filters, separate them with commas. Available operators: `eq`, `ne`, `in`, `not_in`, `gt`, `gte`, `lt`, `lte`. - For `in` and `not_in` operators, provide multiple values separated by the pipe character (`|`). Available fields: `status`.
- `searchTerm` string
- `limit` integer
- `cursor` string

## Response `default`

default response

- ExternalCursorPaginatedResponseV1ModelExternalSelfBilledEInvoiceListItemV1Model
  - `records` ExternalSelfBilledEInvoiceListItemV1Model[]: List of records for the current page
    - `id` string, uuid
    - `companyEntityId` string, uuid
    - `accountingDocumentId` string, uuid, nullable: The accounting document the e-invoice was created for. Null once the accounting document is deleted
    - `accountingDocumentType` 'AP' | 'AR' | 'BP' | 'CC' | 'CN' | 'CT' | 'DE' | 'FX' | 'JE' | 'YC', nullable: ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `linkedSelfBilledEInvoiceId` string, uuid, nullable
    - `type` 'SELF_BILLED_CREDIT_NOTE' | 'SELF_BILLED_INVOICE': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `network` 'FINVOICE' | 'FR_PA' | 'MYDATA' | 'NEMHANDEL' | 'PEPPOL' | 'PORTUGUESE_TAX_REPORTING' | 'SDI' | 'VERIFACTU': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `selfBilledEInvoiceNumber` string, nullable
    - `issueDate` string, date: The date on the self-billed e-invoice
    - `deadline` string, date, nullable: The last day to send the e-invoice to the network
    - `documentNumber` string, nullable: The number on the supplier's document
    - `documentDate` string, date, nullable: The date of the supplier's document
    - `currency` string, nullable
    - `amount` integer, nullable: Total amount in cents, expressed in the invoice currency.
    - `netAmount` DirectedAmount
      - `amount` integer
      - `dcSign` 'D' | 'C': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `taxAmount` DirectedAmount
      - `amount` integer
      - `dcSign` 'D' | 'C': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `buyerName` string
    - `buyerVatNumber` string
    - `supplierName` string
    - `supplierVatNumber` string, nullable
    - `status` 'ACCEPTED' | 'ARCHIVED' | 'DRAFT' | 'FAILED' | 'SUBMITTED': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `failureContext` ExternalUiClientExceptionV1Model, nullable: Failure context when vendor onboarding fails.
      - `name` string: The error name
      - `type` 'BAD_REQUEST' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'NOT_FOUND' | 'CONFLICT' | 'UNPROCESSABLE_CONTENT': The error type ⚠️ This enum is not exhaustive; new values may be added in the future.
      - `errors` ExternalUiClientExceptionErrorV1Model[]: List of errors providing details about what went wrong
        - `type` string: A string code identifying the error type
        - `message` string: A human-readable message providing more details about the error
        - `path` string[], nullable: Optional path of the error when the error is for a specific field. Used mostly on BAD_REQUEST errors, that path will match the field name on the request object
        - `context` object, nullable: Optional context providing additional information about the error. This can include any relevant data that might help in understanding or resolving the error
    - `einvoiceId` string, nullable
    - `submittedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `sdiTdCode` 'TD16' | 'TD17' | 'TD18' | 'TD19' | 'TD20' | 'TD21' | 'TD22' | 'TD23' | 'TD28', nullable: The SDI document type code. Only set on the SDI network ⚠️ This enum is not exhaustive; new values may be added in the future.
  - `hasMore` boolean: Boolean flag indicating if there are more records available
  - `nextCursor` string, nullable: Cursor for fetching the next page
  - `prevCursor` string, nullable: Cursor for fetching the previous page

---

[API](https://skmtc.dev/light/apis/light-api.md) - [All operations](https://skmtc.dev/light/apis/light-api/llms.txt) - [OpenAPI document](https://skmtc.dev/light/apis/light-api/revisions/84f51306f648?raw)