---
title: "Claim Credit Grant Link"
method: POST
path: "/v0/user/claim-credit-grant-link"
tags: ["User"]
---

# Claim Credit Grant Link

`POST /v0/user/claim-credit-grant-link`

Claim a credit grant link.

Credits are applied to the billing account that corresponds to the
caller's active workspace:
- Personal API key → user's BillingAccount
- Organization API key → organization's BillingAccount

Guards:
- Per-link budget: number of claims must stay below max_claims.
- Per-user lifetime: a user can only benefit from one link ever.
- Per-org lifetime: an organization can only benefit from one link ever.

## Request body

- CreditGrantLinkClaimRequest — Request to claim a credit grant link.
  - `token` string, required

## Response `200`

Successful Response

- CreditGrantClaimResponse — Response for claiming a one-time credit grant link.
  - `message` string, required
  - `credits_granted` number, nullable
  - `credited_to` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)