---
title: "Read timestamp credits and invoice order history"
method: GET
path: "/api/v1/control/tenants/{tenantId}/timestamps"
tags: ["Partner billing"]
---

# Read timestamp credits and invoice order history

`GET /api/v1/control/tenants/{tenantId}/timestamps`

## Request

- Base URL: `https://api.custodo.ai`
- URL: `https://api.custodo.ai/api/v1/control/tenants/{tenantId}/timestamps`
- Auth: HTTP bearer

Requires a control-plane session with tenants:read. Partners can only read their own tenants and orders billed to their firm. Returns the price per pack under the tenant owner’s terms; this is not the tenant API-key surface.

## Path parameters

- `tenantId` string, uuid, required

## Response `200`

Success

- object
  - `ok` true, required
  - `data` object, required
    - `included` number, nullable, required
    - `used` number, required
    - `prepaidRemaining` number, required
    - `packUnits` 100, required
    - `unitPriceCents` number, required
    - `currency` 'EUR', required
    - `orders` object[], required
      - `id` string, uuid, required
      - `packs` number, required
      - `amountCents` number, required
      - `createdAt` string, date-time, required

## Other responses

- `404`: Tenant or partner billing account unavailable to this operator.

---

[API](https://skmtc.dev/custodo/apis/custodo-integrazioni.md) · [All operations](https://skmtc.dev/custodo/apis/custodo-integrazioni/llms.txt) · [OpenAPI document](https://skmtc.dev/custodo/apis/custodo-integrazioni/revisions/16d336d3ec2a?raw)