---
title: "Get invite account"
method: GET
path: "/v1/invite/account/{account}"
tags: ["Invite"]
---

# Get invite account

`GET /v1/invite/account/{account}`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/v1/invite/account/{account}`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/invite/account/:account/get.ts> (a function with typed inputs; its response is checked against the schema)

Get invite account info including access status, owned codes, and invitees.

## Path parameters

- `account` string, required

## Response `200`

A successful response.

- ApiGetInviteAccountResponse
  - `has_access` boolean
  - `status` string
  - `invited_by` string
  - `activated_at` string, int64
  - `terms_accepted` boolean
  - `volume` string
  - `invitees_volume` string
  - `cumulative_volume` string
  - `total_codes_earned` integer: Progress toward next code at the upcoming Thursday drop. total_codes_earned is what the next drop will mint based on cumulative_volume so far this week, capped at 5. next_code_threshold is the lowest cumulative_volume value that would unlock one more code; "0" once at the cap.
  - `next_code_threshold` string
  - `next_code_drop_time` string, int64
  - `deposit_deadline` string, int64: DEPRECATED: redemptions no longer expire. Always 0; kept for FE back-compat and will be removed once the FE drops it.
  - `volume_maker` string: Maker / taker split for the current weekly window. Sums of these match `volume` / `invitees_volume` above.
  - `volume_taker` string
  - `invitees_volume_maker` string
  - `invitees_volume_taker` string
  - `invitees_volume_all_time_maker` string: DEPRECATED: moved to GetReferralSummary (referred_volume_all_time_maker / referred_volume_all_time_taker). Still populated for back-compat; will be removed once the FE migrates to the new endpoint.
  - `invitees_volume_all_time_taker` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/v1/invite/account/:account/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)