---
title: "Get IP-to-Company (Reveal API) credit usage"
method: GET
path: "/radar/operator/v1/company/usage"
tags: ["Usage"]
---

# Get IP-to-Company (Reveal API) credit usage

`GET /radar/operator/v1/company/usage`

Returns billable IP-to-Company usage for the current billing cycle, per tracking script. A unit is a distinct successful (HTTP 200) de-anonymisation deduped per (tracking script, monthly window) — the exact figure billing charges a credit for. Operators reconcile this per cycle to know which lookups were billed.

## Response `200`

Usage data retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `usageCycleFrom` string, date-time
    - `usageCycleTo` string, date-time
    - `revealUsage` integer — Total billed IP-to-Company credits this cycle
    - `trackingScriptUsages` object[] — Billed IP-to-Company credits per tracking script
      - `trackingScriptId` string
      - `revealUsage` integer

## Other responses

- `403` — Workspace has no active Reveal API plan

---

[API](https://skmtc.dev/snitcher/apis/snitcher-api.md) · [All operations](https://skmtc.dev/snitcher/apis/snitcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snitcher/snitcher-api/revisions/cb6fa68e7c8e/schema)