---
title: "POST /api/v1/user/invite-codes"
method: POST
path: "/api/v1/user/invite-codes"
tags: ["User"]
---

# POST /api/v1/user/invite-codes

`POST /api/v1/user/invite-codes`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/user/invite-codes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/user/invite-codes/post.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

One earned code minted

- MintInviteCodeResponse
  - `code` string, required

## Other responses

- `409`: No earned code available to claim
- `429`: Rate limited

## Changes

- **2026-09-10** `fad9eecaba2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/user/invite-codes/post.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)