---
title: "Get a buy-credits link"
method: GET
path: "/v1/billing/upgrade-link"
tags: ["Billing"]
---

# Get a buy-credits link

`GET /v1/billing/upgrade-link`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/billing/upgrade-link`
- Auth: HTTP bearer

Returns a URL the agent hands to a human to buy prepaid credits. With
billing configured this is a real Stripe hosted-Checkout session
(`provider: "stripe"`) for the selected pack; credits are available
seconds after the human completes payment. Falls back to a dashboard
billing deep link (`provider: "dashboard"`) on deployments without
Stripe. A human must complete the payment either way.

## Query parameters

- `pack` '10' | '50' | '250' | '1000'

## Response `200`

Buy-credits link.

- object
  - `url` string, uri, required
  - `provider` string, required: 'stripe' (hosted Checkout session) or 'dashboard' (deep link fallback).
  - `requires_human` boolean, required
  - `pack` object: The selected pack (stripe provider only).
  - `message` string

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)