# Current referral

`GET https://api.nexus.gg/v1/referrals/player/{playerId}/code`

Looks up the referral code on file for a player. If the player has no referral on file, the response is `404` with `code` set to `PlayerHasNoReferral`.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Send your **public** API key (`nexus_pk_...`) in the `X-SHARED-SECRET` header. [Generate one](/authentication/api-keys/) in the Publisher Dashboard.

## Path parameters

- `playerId` (string, required) - Unique identifier of the player to look up the current referral code for.

## Query parameters

- `groupId` (string) - Creator group to use for this operation. If your key is scoped to a single program, that group is always used instead of this value; otherwise the lookup falls back to your default group when this is omitted.

## Responses

### 200

Current referral code for the given player

#### Body (`application/json`)

### 404

Specified player has not used a referral code

#### Body (`application/json`)

- `code` (string)