---
title: "Gets every invoice group of the company in full — settings, recipients, columns, sort order, row grouping and the contract jobs in each — active and inactive. For BilfloERP2's invoice group mirror (ERP-11556)."
method: GET
path: "/v{version}/Clients/contractInvoiceGroups"
tags: ["Clients"]
---

# Gets every invoice group of the company in full — settings, recipients, columns, sort order, row grouping and the contract jobs in each — active and inactive. For BilfloERP2's invoice group mirror (ERP-11556).

`GET /v{version}/Clients/contractInvoiceGroups`

## Request

- Base URL: `https://api.bilflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bilflo.com/v{version}/Clients/contractInvoiceGroups`
- Auth: API key in header `Authorization`

## Path parameters

- `version` string, required

## Headers

- `company-id` string, required

## Response `200`

Success

- ClientsContractsQueriesGetInvoiceGroupMirrorResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` BilfloModelsClientsInvoiceGroupMirror
    - `groups` BilfloModelsClientsInvoiceGroupMirrorGroup[], nullable
      - `invoiceGroupId` integer
      - `clientId` integer
      - `name` string, nullable
      - `isActive` boolean
      - `isDefault` boolean
      - `paymentTermId` integer, nullable
      - `paymentTermName` string, nullable
      - `paymentTermDays` integer, nullable
      - `invoiceLayoutTemplateId` integer, nullable
      - `invoiceLayoutTemplateName` string, nullable
      - `invoiceByTypeId` integer
      - `invoiceByCustomFieldId` integer, nullable
      - `frequencyId` integer, nullable
      - `frequencyStartDate` string, date-time, nullable
      - `endDayOne` integer, nullable
      - `endDayTwo` integer, nullable
      - `isTimecardAttached` boolean
      - `isFileUploadAttachedEnabled` boolean
      - `sendByMail` boolean
      - `sendByEmail` boolean
      - `addressId` integer, nullable
      - `addressDisplayName` string, nullable
      - `addressAttentionTo` string, nullable
      - `addressLine1` string, nullable
      - `addressSuite` string, nullable
      - `addressCity` string, nullable
      - `addressStateCode` string, nullable
      - `addressZipCode` string, nullable
      - `addressCityStateZip` string, nullable
      - `remittanceId` integer, nullable
      - `remittanceFileName` string, nullable
      - `message` string, nullable
      - `placeInFooter` boolean
      - `showJobTitleInInvoice` boolean
      - `acaTypeInvoices` integer
      - `isGroupSickTimeWithRegular` boolean
      - `createdAt` string, date-time
    - `contacts` BilfloModelsClientsInvoiceGroupMirrorContact[], nullable
      - `invoiceGroupId` integer
      - `contactId` integer
      - `kind` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `emailAddress` string, nullable
    - `groupingFields` BilfloModelsClientsInvoiceGroupMirrorField[], nullable
      - `invoiceGroupId` integer
      - `groupField` string, nullable
    - `visibleColumns` BilfloModelsClientsInvoiceGroupMirrorColumn[], nullable
      - `invoiceGroupId` integer
      - `columnName` string, nullable
      - `columnOrder` integer
      - `template` string, nullable
      - `isCustom` boolean
    - `sortColumns` BilfloModelsClientsInvoiceGroupMirrorSort[], nullable
      - `invoiceGroupId` integer
      - `name` string, nullable
      - `columnOrder` integer
    - `jobs` BilfloModelsClientsInvoiceGroupMirrorJob[], nullable
      - `invoiceGroupId` integer
      - `jobId` integer

## Changes

- **2026-10-26** `da5166580e84`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bilflo/apis/bilflo-api/changes/v:version/Clients/contractInvoiceGroups/get.md)

---

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