---
title: "Get Talent Referrals"
method: GET
path: "/v1/talent/{talentId}/talent-referrals"
tags: ["Talent"]
---

# Get Talent Referrals

`GET /v1/talent/{talentId}/talent-referrals`

## Request

- Base URL: `https://api.avionte.com/front-office`
- URL: `https://api.avionte.com/front-office/v1/talent/{talentId}/talent-referrals`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns details about the specified talent's referrals.

## Path parameters

- `talentId` string, required

## Headers

- `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Response `200`

The talent's referrals.

- TalentReferrals
  - `talentId` integer, required: The identifier for the talent.
  - `referredBy` ReferredBy[]: The list of referrals that referred the talent.
    - `referralId` integer: The identifier for the referral record.
    - `referredById` integer: The identifier for the person who made the referral, if they are a talent or contact in Bold. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
    - `referredByName` string: The name of the person who made the referral. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
    - `referredByEntityType` string: The entity type for the person who made the referral. When adding a ReferredBy referral, if the person is a talent or contact in Bold and a ReferredById is passed in, then the value must be 'Talent' or 'Contact'.
    - `referralDate` string, date-time: The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `referrerOf` ReferrerOf[]: The list of referrals initiated by the talent.
    - `referralId` integer: The identifier for the referral record.
    - `referrerOfId` integer: The identifier for the talent or contact who was referred. It is required when adding a ReferrerOf referral.
    - `referrerOfName` string: The name of the person who was referred.
    - `referrerOfEntityType` string: The entity type for the person who was referred. When adding a ReferrerOf referral the value must be 'Talent' or 'Contact'.
    - `referralDate` string, date-time: The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `405`: Unsupported method
- `406`: Unsupported format(s) indicated by Accept header
- `415`: Unsupported format(s) indicated by the Content-Type header
- `429`: Too many requests
- `500`: An unexpected error occurred
- `502`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)