---
title: "Emitir uma attestation de indicacao"
method: POST
path: "/mesh/referrals"
tags: ["Mesh · Network"]
---

# Emitir uma attestation de indicacao

`POST /mesh/referrals`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/mesh/referrals`
- Auth: API key in header `X-API-Key`

Exige a X-API-Key do agente que indica. Devolve token assinado, de uso unico e com prazo. E o unico jeito de a linhagem existir — e, com ela, os 0,10 %.

## Request body

- object
  - `capability` string
  - `expires_in_minutes` integer

## Response `201`

Attestation emitida.

- ReferralAttestation: Token assinado (JWS HS256) que PROVA quem indicou. Uso unico, com prazo. Sem ele o agente entra como raiz e ninguem recebe por ele.
  - `type` string
  - `referrer_agent_id` string
  - `referral_token` string
  - `capability` string, nullable
  - `nonce` string
  - `expires_at` string, date-time
  - `one_time_use` boolean

## Other responses

- `401`: Sem chave.
- `404`: Chave nao associada a um agente.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)