---
title: "List performance obligations"
method: GET
path: "/v3/performance-obligations"
tags: ["Performance Obligations"]
---

# List performance obligations

`GET /v3/performance-obligations`

## Query parameters

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

## Response `200`

Get all performance obligations by filter

- object
  - `payload` object, required — Response payload, will be empty when success is false
    - `data` GetPerformanceObligationItemDto[]
      - `id` string, required — Unique identifier for the performance obligation
      - `name` string, nullable, required — Name of the performance obligation
      - `contractId` string, required — ID of the contract this performance obligation belongs to
      - `billingTermGroupId` string, nullable, required — Billing term group ID (foreign key)
      - `billingTermGroupName` string, nullable, required — Billing term group name
      - `itemId` string, nullable, required — ID of the associated integration item
      - `itemName` string, nullable, required — Name of the associated integration item
      - `erpClassId` string, nullable, required — ID of the ERP class
      - `erpClassName` string, nullable, required — Name of the ERP class
      - `category` string, nullable, required — Revenue category
      - `considerationType` string, nullable, required — Consideration type
      - `recognitionPattern` string, nullable, required — Revenue recognition pattern
      - `eventTypeId` string, nullable, required — Event type ID
      - `eventTypeName` string, nullable, required — Event type name
      - `productId` string, nullable, required — ID of the associated product
      - `productName` string, nullable, required — Name of the associated product
      - `serviceStartDate` string, date-time, required — Service start date
      - `serviceEndDate` string, date-time, required — Service end date
      - `transactionPrice` string, required — Transaction price as a decimal string
      - `recognizedRevenue` RecognizedRevenueAtomResponseDto[], required — Monthly recognized revenue entries for this performance obligation
        - `timeframe` string, required — Month in YYYY-MM format
        - `total` string, required — Recognized revenue amount as a decimal string
      - `createdAt` string, date-time, required — Timestamp when the performance obligation was created
      - `updatedAt` string, date-time, required — Timestamp when the performance obligation 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` — Performance obligation features are not enabled for this merchant

---

[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/revisions/7e8885517814/schema)