---
title: "Read the caller's referral status"
method: GET
path: "/v1/referrals"
tags: ["Agents & capabilities"]
---

# Read the caller's referral status

`GET /v1/referrals`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/referrals`
- Auth: HTTP bearer

Returns the caller's code, attribution and activation counts, credit balance, and fee-share accruals.

## Response `200`

Current referral status.

## Other responses

- `401`: Agent key missing or unknown.
- `429`: Referral request limit reached.
- `503`: Referral status is unavailable.

---

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