---
title: "Retrieve remaining product benefits for a given credit party"
method: POST
path: "/lookup/credit-party-benefits"
tags: ["Credit-Party"]
---

# Retrieve remaining product benefits for a given credit party

`POST /lookup/credit-party-benefits`

## Request body

- object
  - `service_id` integer, required — Service identifier. See [Services](#tags/Services) for more details.
  - `credit_party_identifier` object, required
    - `mobile_number` string — Mobile number in [E.164](https://en.wikipedia.org/wiki/E.164) format.
    - `account_number` string — Account number.
    - `account_qualifier` string
  - `page` integer — Page number
  - `per_page` integer — Number of records per page

## Response `200`

successful operation

- CreditPartyBenefit[]
  - `type` 'TALKTIME' | 'DATA' | 'SMS' | 'PAYMENT' | 'CREDITS', required
  - `unit_type` 'TIME' | 'DATA' | 'QUANTITY' | 'CURRENCY', required
  - `unit` string, required
  - `amount` number, double, required
  - `expiration_date` string, date-time, nullable, required — A `null` value denotes either no expiration applies or that the product benefit has not yet been activated.
  - `country` Country, required
    - `name` string, required
    - `iso_code` string, required — Country code in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format. Note that the official list can be extended with additional country codes.
    - `regions` ServiceRegion[], nullable, required
      - `name` string, required
      - `code` string, required — Country subregion code in [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) format. Note that the official list can be extended with additional country codes.

## Other responses

- `default` — default error response

---

[API](https://skmtc.dev/dtone/apis/digital-value-services-api.md) · [All operations](https://skmtc.dev/dtone/apis/digital-value-services-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dtone/apis/digital-value-services-api/revisions/41b676566ef8?raw)