List invoices

GET

https://integrators.prod.api.tabsplatform.com/v3/invoices

GET

/v3/invoices

curl -G https://integrators.prod.api.tabsplatform.com/v3/invoices \
     -H "Authorization: <apiKey>" \
     -d page=1 \
     -d limit=50

200Retrieved

{
  "payload": {
    "data": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "issueDate": "2021-01-01",
        "dueDate": "2021-01-01",
        "sentDate": "2021-01-01",
        "scheduledSendDate": "2021-01-01",
        "createdAt": "2021-01-01",
        "status": "DRAFT",
        "displayStatus": "SCHEDULED",
        "invoiceNumber": "1234",
        "memo": "A memo / note on the invoice",
        "customFields": [
          "string"
        ],
        "source": "TABS",
        "customerId": "123e4567-e89b-12d3-a456-426614174000",
        "originalDueDate": "2021-01-01",
        "originalIssueDate": "2021-01-01",
        "total": 100,
        "balanceRemaining": 100,
        "externalIds": [
          {
            "type": "QUICKBOOKS",
            "id": "123e4567-e89b-12d3-a456-426614174000"
          }
        ],
        "lineItems": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "billingTermId": "123e4567-e89b-12d3-a456-426614174000",
            "name": "Item 1",
            "description": "string",
            "quantity": 1,
            "unitPrice": 100,
            "subtotal": 110,
            "discountTotal": 10,
            "total": 100,
            "serviceStartDate": "2026-01-01",
            "serviceEndDate": "2026-02-28",
            "salesTaxRate": "8.5",
            "item": {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "name": "Item 1",
              "displayName": "Item 1 (Annual)",
              "externalIds": [
                {
                  "type": "NETSUITE",
                  "id": "123e4567-e89b-12d3-a456-426614174000",
                  "objectType": "Account",
                  "objectLabel": "Account"
                }
              ]
            }
          }
        ],
        "paymentLink": "string",
        "poNumber": "1234",
        "paidOn": "2024-01-15T00:00:00.000Z",
        "uncollectibleOn": "2024-02-01T00:00:00.000Z",
        "lastUpdatedAt": "2024-01-01T00:00:00.000Z"
      }
    ],
    "limit": 1.1,
    "totalItems": 1.1,
    "currentPage": 1.1
  },
  "success": true,
  "message": "string",
  "error": {
    "code": 1.1,
    "message": "string",
    "errorCode": "string",
    "details": {}
  }
}

Authentication

Authorizationstring

API Key authentication via header

Query parameters

pagedoubleRequiredDefaults to 1

Page Number

limitdoubleRequiredDefaults to 50

Number of items to return

filterstringOptional

Format: field:rule:value — comma-separated for multiple filters.

Fields: customerId (uuid): eq, neq, in, nin, isnull, isnotnull total (number): eq, neq, gt, gte, lt, lte, in, nin contractId (uuid): eq, neq, in, nin, isnull, isnotnull obligationId (uuid): eq, neq, in, nin, isnull, isnotnull source (string): eq, neq, like, nlike, in, nin, isnull, isnotnull status (string): eq, neq, in, nin displayStatus (string): eq, neq, in, nin issueDate (datetime): eq, neq, gt, gte, lt, lte dueDate (datetime): eq, neq, gt, gte, lt, lte lastUpdatedAt (datetime): eq, neq, gt, gte, lt, lte

Date-only values (YYYY-MM-DD) match the full UTC day.

Example: filter=customerId:eq:00000000-0000-0000-0000-000000000001

Response

Get all Invoices by filter

payloadobject

Response payload, will be empty when success is false

successboolean

Boolean with true=success, false=failure

messagestring

Plain-text description of the result

errorobjectOptional

json element with any error messages or warnings