---
title: "List current user's referral events"
method: GET
path: "/referrals/me/events"
tags: ["Referrals"]
---

# List current user's referral events

`GET /referrals/me/events`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/referrals/me/events`
- Auth: none declared. Required headers: `Authorization`

Lists the signed-in user's recent referral records, newest first, whether they were the referrer or the referred account. `limit` caps the count at 100. Each item has its code, campaign, `role`, `status` (including `clawed_back`), `reward_credits` and created, qualified, rewarded and expiry times.

## Query parameters

- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Referral events

- ReferralsReferralsEventsResponseDoc
  - `items` ReferralsReferralAttributionDoc[]
    - `campaign` string
    - `code` string
    - `created_at` string
    - `expires_at` string
    - `id` string
    - `qualified_at` string
    - `reward_credits` integer
    - `rewarded_at` string
    - `role` 'referrer' | 'referred'
    - `status` 'attributed' | 'qualified' | 'review_required' | 'rewarded' | 'expired' | 'capped' | 'failed' | 'rejected'

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

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