---
title: "Get remaining service credits"
method: GET
path: "/v1/usage/{serviceType}"
tags: ["Usage"]
---

# Get remaining service credits

`GET /v1/usage/{serviceType}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/usage/{serviceType}`
- Auth: HTTP bearer

Gets the current account credit balance and expiry for Cell tower Plus (ADL) or Geofencing (GF).

## Path parameters

- `serviceType` 'ADL' | 'GF', required

## Response `200`

OK

- object: Current credit balance and expiry for the requested service.
  - `credits` integer, required: Remaining service credits. Depleted balances return 404.
  - `expiryDate` string, date-time, nullable, required: Credit expiry date in ISO-8601 format, or null when no expiry is set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)