List your partner referrals
The leads your agency has referred to Corefinity, newest first. Your role needs the viewAgencyLeads permission. Paged by cursor: send next_cursor back as cursor; null means the last page.
Query parameters
Items a page. Defaults to 25. 1 to 100.
The next_cursor of the previous answer. It is a page number as a string of digits; anything else is refused 422 on cursor.
Part of a company name or website address. Up to 255 characters.
Returns
200 One page of referrals.
Fields of the 200 answer
The paging field of a cursor-paged list. The list itself sits beside it under a key each endpoint names, such as items or sites.
Fields
Send as cursor to read the next page. Null on the last page.
Fields of each item
Whether Corefinity may contact the lead directly.
Format: date-time.
What the lead pays for hosting today.
Who hosts the lead today.
At least 1.
The mobile number in international form, such as +447700900123.
The two-letter country code the number was read with.
Your notes. When Corefinity may contact the lead and the contact's mobile or email is missing, a line saying so is added.
emailphonenullThe lead's website, as it was typed. The scheme is optional.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | forbidden | The person is not allowed to do this. |
403 | scope_required | Use a token with the scope named in scope. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/agency/referrals \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/agency/referrals');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/agency/referrals', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/agency/referrals",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"data": {
"items": [
{
"company_name": "Harbour & Finch",
"contact_lead": true,
"created_at": "2026-11-09T10:15:00Z",
"current_cost": 120.5,
"current_provider": "Another host",
"id": 3120,
"main_contact_email": "[email protected]",
"main_contact_mobile": "+447700900123",
"main_contact_mobile_country": "GB",
"main_contact_name": "Eleanor Finch",
"notes": "Moving this quarter.",
"preferred_contact_method": "phone",
"website_url": "https://harbourandfinch.example.com"
}
],
"next_cursor": null
}
}{
"message": "Unauthenticated."
}{
"code": "forbidden",
"message": "You are not allowed to view partner referrals.",
"reason": "forbidden",
"status": "error"
}{
"code": "invalid",
"errors": {
"limit": [
"The limit may not be greater than 100."
]
},
"field": "limit",
"message": "The limit may not be greater than 100.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}