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

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

`GET /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/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Earned invite-code standing

- InviteCodesResponse
  - `available` integer, required
  - `cap` integer, required
  - `claimed` integer, required
  - `codes` InviteCodeEntry[], required
    - `code` string, required
    - `createdAtMs` integer, required
    - `redeemedBy` string, nullable
    - `status` string, required: `active` or `used`.
  - `earned` integer, required
  - `gatingEnabled` boolean, required: Root-whitelist enforcement. When false, invite codes are unused.
  - `volumeUsdc` string, required

## Changes

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

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/user/invite-codes/get.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)