---
title: "Get referral billing"
type: reference
method: GET
path: /rest-api/referral/getBilling.do
tag: "Users"
---

# Get referral billing

`GET https://YOUR-NETWORK-DOMAIN/rest-api/referral/getBilling.do`

Returns the complete referral program billing data for the authenticated user's account. The response is a SearchResult containing all ReferralProgramBilling records with no pagination limit. Each billing record includes referral earnings, payment status, and associated referral details. Requires the REFERRAL_PROGRAM_BILLING admin UI permission; returns HTTP 403 naming the permission if the user lacks it.

## Responses

- `200` — SearchResult containing 'data' array of ReferralProgramBilling objects and 'total' count
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden - user lacks REFERRAL_PROGRAM_BILLING permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/referral/getBilling.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-referral-getbilling