Skip to main content
GET
/
api
/
v4.0
/
integrations
/
referrals
/
validate
Validate Referrer Code
curl --request GET \
  --url https://api.gameball.co/api/v4.0/integrations/referrals/validate \
  --header 'apikey: <api-key>'
{
  "isValid": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.gameball.co/llms.txt

Use this file to discover all available pages before exploring further.

The API call validates whether a provided referral code is valid and eligible for use during customer signup. It optionally checks if the referral code belongs to a different customer to prevent self-referral. This allows clients to pre-validate referral codes before creating a customer record.
Security: Requires apiKey header.

Authorizations

​
apikey
string
header
required

Query Parameters

​
referrerCode
string
required

The referral code to validate

​
forCustomerId
string

Customer ID to prevent self-referral

Response

200 - application/json

Referral code validation result

​
isValid
boolean

Indicates whether the provided referral code is valid and eligible for use