---
title: "Check for pending referral"
method: POST
path: "/referral/check-pending"
tags: ["referral"]
---

# Check for pending referral

`POST /referral/check-pending`

Called by the app on first launch to retrieve deferred deep link referral information.

## Request body

- CheckPendingReferralDto
  - `device_fingerprint` string, required — Device fingerprint/identifier (device ID, advertising ID, etc.)
  - `ip_address` string — IP address (optional, for additional matching)
  - `user_agent` string — User agent string (optional)
  - `platform` string — Platform (android, ios, etc.)
  - `claiming_member_id` string — Member ID of the user claiming the referral (optional, if user is already registered)

## Response `200`

Pending referral check result

- PendingReferralResponseDto
  - `has_pending_referral` boolean, required — Whether a pending referral was found
  - `referrer_member_id` string — Referrer member ID if found
  - `utm_source` string — UTM source if available
  - `utm_medium` string — UTM medium if available
  - `utm_campaign` string — UTM campaign if available

---

[API](https://skmtc.dev/tonewow/apis/tonewow-database-api.md) · [All operations](https://skmtc.dev/tonewow/apis/tonewow-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonewow/tonewow-database-api/revisions/f36472974ad4/schema)