---
title: "POST /billing/{tenantLocator}/invoices/earlyInvoicing"
method: POST
path: "/billing/{tenantLocator}/invoices/earlyInvoicing"
---

# POST /billing/{tenantLocator}/invoices/earlyInvoicing

`POST /billing/{tenantLocator}/invoices/earlyInvoicing`

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/billing/{tenantLocator}/invoices/earlyInvoicing`
- Auth: none declared

## Path parameters

- `tenantLocator` string, uuid, required

## Request body

- EarlyInvoicingRequest
  - `accountLocator` string, ulid
  - `invoiceThroughTime` string, date-time
  - `installmentLocators` string[], required
  - `invoiceDueTime` string, date-time
  - `timezone` string
  - `ignoreHolds` boolean, required
  - `policyLocator` string, ulid
  - `aggregateInvoices` boolean, required: Defaults to `false`. When `true`, the job creates an aggregate invoice for each account and currency, containing the regular invoices that were generated.
  - `includeExistingInvoices` boolean, required: Defaults to `false`. When `true`, that aggregate invoice also includes the other open regular invoices for the account in the same currency that are not already on an aggregate invoice. Requires `aggregateInvoices: true`.

## Response `200`

OK

- EarlyInvoicingResponse
  - `jobLocator` string, ulid, required
  - `candidateInstallmentsCount` integer, required

---

[API](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi.md) - [All operations](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/revisions/6537d24b3693?raw)