Skip to main content
GET
/
api
/
v4.0
/
integrations
/
customers
/
{customerId}
/
referrals
Get Customer Referrals
curl --request GET \
  --url https://api.gameball.co/api/v4.0/integrations/customers/{customerId}/referrals \
  --header 'apikey: <api-key>'
{
  "referredFriends": [
    {
      "customerId": "<string>",
      "displayName": "<string>",
      "email": "<string>",
      "mobileNumber": "<string>",
      "joinDate": "<string>",
      "status": "Active"
    }
  ],
  "count": 123,
  "hasMore": true
}
This API retrieves a list of customers referred by a specified customer in Gameball, including each referral’s join date and current status within the referral program.
Security: Requires apikey and secretkey headers.

Authorizations

​
apikey
string
header
required

Path Parameters

​
customerId
string
required

Unique identifier for the customer

Query Parameters

​
startAfter
integer<int64>
default:0

Specifies the page will start after which Gameball customer id

​
limit
integer
default:50

Number of referrals to return per page

Required range: x <= 200

Response

200 - application/json

Customer referrals found

​
referredFriends
object[]

A list of friends referred by the customer

​
count
number

The total number of friends on the current page

​
hasMore
boolean

Whether there are additional friends to be fetched