---
title: "Get the progress toward the next tier for a customer."
method: GET
path: "/v1/pvt/Customer/{id}/tier/next"
tags: ["Customer"]
---

# Get the progress toward the next tier for a customer.

`GET /v1/pvt/Customer/{id}/tier/next`

## Request

- Base URL: `https://api.bonifiq.com.br`
- URL: `https://api.bonifiq.com.br/v1/pvt/Customer/{id}/tier/next`
- Auth: HTTP basic

## Path parameters

- `id` string, required

## Response `200`

- BaseExternalApiResponseOfListOfCustomerNextTierProgressResponse: Standard response envelope used by the External API.
  - `ErrorMessage` string, nullable: Error message returned when the request fails validation or processing. For warnings and successful responses, consumers should usually inspect `Result`, `Code` and `Severity` first.
  - `ErrorCode` integer, nullable: Legacy numeric error code derived from internal API errors when available. This field is relevant only for error flows that use `ApiResponseErrorDescription`.
  - `Result` object[], nullable: Business payload returned by the endpoint.
    - `TargetType` 0 | 1 | 2 | 3: 0 = Point 1 = Expense 2 = Purchase 3 = Referral
    - `Target` number, double
    - `Current` number, double
    - `Balance` number, double
    - `Percent` number, double
    - `ProgressDescription` string, nullable
    - `Due` string, date-time
    - `DueDate` string, date-time, nullable
    - `DueString` string, nullable
    - `DueInDays` integer, nullable
    - `OnTarget` boolean
  - `Code` string, nullable: Endpoint-specific business code formatted as a two-digit string, such as `03` or `07`. This field is available for success, warning and error outcomes.
  - `CodeName` string, nullable: Symbolic enum name associated with `Code`, such as `CheckoutNotFound`.
  - `Severity` 0 | 1 | 2: 0 = Success 1 = Warning 2 = Error
  - `HasWarning` boolean: Convenience flag that is `true` when `Severity` is `Warning`. Warnings are valid `200 OK` business outcomes and should not be handled as transport or validation errors.
  - `HasError` boolean: Indicates whether the request failed and should be handled as an error response. This flag is reserved for real API errors; warnings must keep this property as `false`.

## Changes

- **2026-07-21** `760e443ffa9b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bonifiq/apis/bonifiq-private-apis/changes/v1/pvt/Customer/:id/tier/next/get.md)

---

[API](https://skmtc.dev/bonifiq/apis/bonifiq-private-apis.md) - [All operations](https://skmtc.dev/bonifiq/apis/bonifiq-private-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/bonifiq/apis/bonifiq-private-apis/revisions/bac0977b23d5?raw)