---
title: "Issue or read the caller's referral code"
method: POST
path: "/v1/referrals"
tags: ["Agents & capabilities"]
---

# Issue or read the caller's referral code

`POST /v1/referrals`

## Request

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

## Response `200`

Referral code and current 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)