---
title: "List contract billing term groups"
method: GET
path: "/v3/contracts/{id}/billing-term-groups"
tags: ["Contracts"]
---

# List contract billing term groups

`GET /v3/contracts/{id}/billing-term-groups`

## Path parameters

- `id` string, required

## Query parameters

- `page` number, required
- `limit` number, required
- `filter` string

## Response `200`

Billing term groups for the contract

- object
  - `payload` object, required — Response payload, will be empty when success is false
    - `data` BillingTermGroupDto[]
      - `id` string, uuid, required — Billing term group ID
      - `name` string, nullable, required — Billing term group name
      - `billingTermIds` string[], required — Billing term IDs assigned to this group
      - `performanceObligationIds` string[], required — Performance obligation IDs assigned to this group
      - `createdAt` string, date-time, required — Timestamp when the billing term group was created
      - `updatedAt` string, date-time, required — Timestamp when the billing term group was last updated
    - `limit` number
    - `totalItems` number
    - `currentPage` number
  - `success` boolean, required — Boolean with true=success, false=failure
  - `message` string, required — Plain-text description of the result
  - `error` IntegratorsApiError, required
    - `code` number, required — API response code
    - `message` string, required — API response message
    - `details` object — Additional details about the error

## Other responses

- `400` — Invalid contract ID or performance obligation features not enabled for this merchant
- `404` — Contract not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/versions/7e8885517814/schema)