GET
/
v1
/
invoice
Get invoices
curl --request GET \
  --url http://localhost:3001/v1/invoice \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "originalFileName": "<string>",
      "filename": "<string>",
      "recipientName": "<string>",
      "recipientIban": "<string>",
      "recipientVat": "<string>",
      "recipient": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "email": "<string>",
        "markedTrusted": true,
        "markedTrustedDate": "2023-11-07T05:31:56Z",
        "markedTrustedUser": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true
        },
        "description": "<string>",
        "vat": "<string>",
        "accountsPayableNumber": "22 0391919",
        "bankAccount": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "name": "<string>",
          "iban": "<string>",
          "bic": "<string>",
          "countryCode": "<string>",
          "address": "<string>"
        }
      },
      "invoiceNumber": "<string>",
      "purchaseOrder": "<string>",
      "date": "<string>",
      "billingPeriodStart": "<string>",
      "billingPeriodEnd": "<string>",
      "dueDate": "<string>",
      "skontoDate": "<string>",
      "skontoAmount": 123,
      "skontoRate": 123,
      "totalAmount": 123,
      "currency": "EUR",
      "type": "INVOICE",
      "paymentTerms": "<string>",
      "notes": "<string>",
      "shouldCreateTransaction": true,
      "alreadyPaid": false,
      "alreadyPaidDate": "<string>",
      "archived": false,
      "archivedDate": "<string>",
      "archivedByUser": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "email": "<string>",
        "name": "<string>",
        "authId": "<string>",
        "role": "<string>",
        "hasPushNotification": true
      },
      "organization": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "slug": "<string>",
        "logoFileName": "<string>",
        "featureFlags": [
          {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "featureName": "<string>",
            "isEnabled": true
          }
        ]
      },
      "status": "NEW",
      "debitor": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "iban": "<string>",
        "bic": "<string>",
        "countryCode": "<string>",
        "address": "<string>"
      },
      "export": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "invoiceCount": 123
      },
      "splits": [
        {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "partialAmount": 123,
          "taxRate": 123,
          "notes": "<string>",
          "costCenter": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "code": "<string>",
            "name": "<string>",
            "type": "<string>"
          },
          "costCenter2": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "code": "<string>",
            "name": "<string>",
            "type": "<string>"
          },
          "ledgerAccount": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "accountNumber": "<string>",
            "name": "<string>"
          }
        }
      ],
      "lineItems": [
        {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "productCode": 123,
          "title": "<string>",
          "description": "<string>",
          "quantity": 123,
          "unit": 123,
          "unitPrice": 123,
          "totalPrice": 123,
          "discount": 123,
          "taxRate": 123,
          "taxAmount": 123
        }
      ]
    }
  ],
  "meta": {
    "page": 123,
    "take": 123,
    "itemCount": 123,
    "pageCount": 123,
    "hasPreviousPage": true,
    "hasNextPage": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
searchTerm
string

The search term to look for in the invoice list.

​
status
string

Filter invoices by status.

​
recipientIds
string

Filter invoices by their recipient ids.

​
dateFrom
string

Filter invoices dates from

​
dateTo
string

Filter invoices dates to

​
dueFrom
string

Filter invoices due date from

​
dueTo
string

Filter invoices due date to

​
skontoFrom
string

Filter invoices skonto date from

​
skontoTo
string

Filter invoices skonto date to

​
costCenter1Ids
string

Filter invoices by their cost center 1 ids.

​
costCenter2Ids
string

Filter invoices by their cost center 2 ids.

​
ledgerAccountIds
string

Filter invoices by their ledger accounts ids.

​
approvalRequesterIds
string

Filter invoices by their approval requester (user).

​
currentApproverIds
string

Filter invoices by their current approvers (user).

​
invoiceTypes
string

Filter invoices by type (invoice, credit note).

​
orderField
string

Specify the field you want to order by.

​
orderDir
string

Choose between ascending and descending order.

​
order
enum<string>
default:ASC

Choose between ascending and descending order.

Available options:
ASC,
DESC
​
page
number
default:1

Specify the number of the page you want to retrieve.

Required range: x >= 1
​
take
number
default:10

Specify the number of items you want to retrieve per page.

Required range: 1 <= x <= 100

Response

200 - application/json

The response is of type object.