Skip to content
Leadtime
English
Esc
↑↓navigate↵open⌘Jpreview

Get new invoices grid

Returns a paginated, filterable, and sortable grid of invoices that are created but not yet sent, or sent but not yet overdue.

What are New Invoices? The “New” tab shows all invoices that have been created but not yet sent, or invoices that have been sent but are not yet overdue. These invoices are in status “New” or “Sent” and have either no due date or a due date in the future.

What is returned:

  • Invoice identification (ID, number)
  • Project reference (projectId)
  • Invoice type (Mixed, Subscription, TimeBased, ExpressQuotation, SingleProject, InterimPayment)
  • Creation and sending dates (createdAt, sentAt)
  • Payment due date (dueDate)
  • Net amount before taxes and fees (netto)
  • Invoice status (New, Sent)

Filtering and search:

  • Quick search across invoice number
  • Filter by project, type, status, dates, and amount
  • Sort by any field

Retrieves a paginated grid of new invoices with filtering and sorting capabilities. Quick search available on: number. Filterable fields: id, number, projectId, type, createdAt, sentAt, dueDate, netto, status. Sortable fields: id, number, projectId, type, createdAt, sentAt, dueDate, netto, status.

GET/billing/invoices/new
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Query parameters
pagenumber

Page number (1-based)

pageSizenumber

Number of items per page

viewIdstring

View identifier for saved grid configurations

quickSearchstring

Quick search text. Searches across: number

filtersstring

JSON string containing filter configuration.

Available Fields:

  • id (string): Invoice ID
  • number (string): Invoice number
  • projectId (string): Project ID
  • type (set): Invoice type (Mixed, Subscription, TimeBased, ExpressQuotation, SingleProject, InterimPayment)
  • createdAt (date): Invoice creation date
  • sentAt (date): Date when invoice was sent
  • dueDate (date): Payment due date
  • netto (number): Net amount (before taxes and fees)
  • status (set): Invoice status (New, Sent)

Filter Structure:

[
  {
    "type": "string|number|date|set|boolean|array|task_status|task_type",
    "fieldName": "field_name",
    "value": {
      "comparison": "comparison_type",
      "value": "filter_value"
    }
  }
]

Group Filters (AND/OR Combinations):

[
  {
    "type": "group",
    "fieldName": "group0.18807479823070028",
    "value": {
      "type": "or",
      "filters": [
        {
          "type": "string",
          "fieldName": "fileName",
          "value": {
            "comparison": "contain",
            "value": "aa"
          }
        },
        {
          "type": "number",
          "fieldName": "rowCount",
          "value": {
            "comparison": ">=",
            "value": 33
          }
        }
      ]
    }
  }
]

Available Comparison Operators:

  • id (string): Invoice ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty
  • number (string): Invoice number (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty
  • projectId (string): Project ID (string filter). Available comparisons: contain, not_contain, equal, starts_with, ends_with, is_empty, is_not_empty
  • type (set): Invoice type (Mixed, Subscription, TimeBased, ExpressQuotation, SingleProject, InterimPayment) (set filter). Available comparisons: in, not_in, is_empty, is_not_empty
  • createdAt (date): Invoice creation date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
  • sentAt (date): Date when invoice was sent (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
  • dueDate (date): Payment due date (date filter). Available comparisons: equal, not_equal, >, <, >=, <=, between, lastMonth, thisMonth, is_empty, is_not_empty
  • netto (number): Net amount (before taxes and fees) (number filter). Available comparisons: equal, not_equal, >, <, >=, <=, is_empty, is_not_empty
  • status (set): Invoice status (New, Sent) (set filter). Available comparisons: in, not_in, is_empty, is_not_empty

Note: Use quickSearch parameter for simple text search instead of adding it to filters.

sortstring

JSON array of sort objects.

Sortable Fields:

  • id: Invoice ID
  • number: Invoice number
  • projectId: Project ID
  • type: Invoice type (Mixed, Subscription, TimeBased, ExpressQuotation, SingleProject, InterimPayment)
  • createdAt: Invoice creation date
  • sentAt: Date when invoice was sent
  • dueDate: Payment due date
  • netto: Net amount (before taxes and fees)
  • status: Invoice status (New, Sent)

Sort Structure:

[
  {
    "field": "field_name",
    "direction": "asc|desc"
  }
]

Default Sort: createdAt (desc)

fieldsToReturnstring[]

Comma-separated list of field names to include in response items. If not provided, all fields are returned.

Available Fields: id, number, projectId, type, createdAt, sentAt, dueDate, netto, status

Responses
200

Successfully retrieved new invoices grid

400

Invalid query parameters

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Parameters
Request
curl -X GET "https://leadtime.app/api/public/billing/invoices/new" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
Successfully retrieved new invoices grid