---
title: "List my invited users"
method: GET
path: "/referrals/invited"
tags: ["referrals"]
---

# List my invited users

`GET /referrals/invited`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/referrals/invited`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Accounts that joined on the caller's referral code, newest first, each with kyc_verified. ?kyc=true|false filters (total follows the filter); the top-level kyc_verified rollup always counts ALL invitees who finished KYC — user-facing invite counters must render that number, never raw signups.

## Query parameters

- `kyc` boolean
- `limit` integer
- `offset` integer

## Response `200`

OK

- InternalDeliveryHttpHandlerReferralInvitedResponse
  - `data` EnforcerV3InternalDomainReferralInvitedUser[]
    - `account_id` string
    - `active` boolean
    - `email` string
    - `first_name` string
    - `joined_at` string
    - `kyc_verified` boolean
    - `last_name` string
    - `username` string
  - `kyc_verified` integer
  - `limit` integer
  - `offset` integer
  - `success` boolean
  - `total` integer

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)
