---
title: "Read claim, email and recipient usage results [admin]"
method: GET
path: "/credit-campaigns/{id}"
tags: ["Credit campaigns"]
---

# Read claim, email and recipient usage results \[admin\]

`GET /credit-campaigns/{id}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/credit-campaigns/{id}`
- Auth: HTTP bearer

Returns grantedUsd, claimed, activeRecipients, agentUsageUsd and individual link states. Usage is agent/runtime ledger spend since first claim, excludes API gateway and is not attribution to the gifted credit pool.

## Path parameters

- `id` string, required

## Response `200`

Campaign result

- object
  - `campaignId` string, required
  - `note` string, required
  - `amountUsd` number, required
  - `maxRedemptions` integer, required
  - `claimed` integer, required
  - `grantedUsd` number, required
  - `activeRecipients` integer, required
  - `agentUsageUsd` number, required
  - `usageBasis` string, required
  - `links` object[], required
    - `id` string, required
    - `email` string, nullable, required
    - `state` 'active' | 'disabled' | 'expired' | 'exhausted', required
    - `claimed` integer, required
    - `emailStatus` string, required
    - `expiresAt` string, required
    - `notifiedAt` string, nullable, required
    - `url` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Admin token scope and administrator allowlist membership required
- `404`: Unknown campaign
- `503`: Campaign migrations required
- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 5 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `404`
  - …1 more

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/credit-campaigns/:id/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)