---
title: "Retrieves a candidate's next-of-kin details"
method: GET
path: "/candidate/{candidateId}/profile/next-of-kin"
tags: ["Candidate"]
deprecated: true
---

# Retrieves a candidate's next-of-kin details

`GET /candidate/{candidateId}/profile/next-of-kin`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/candidate/{candidateId}/profile/next-of-kin`
- Auth: none declared. Required headers: `Authorization`, `Context`

> **Deprecated.**

Retrieves a candidate's next-of-kin details

## Path parameters

- `candidateId` string, required

## Headers

- `Authorization` string, string, required
- `Context` string, string, required

## Response `200`

success response for next-of-kin details retrieval

- NextOfKinDetailsWithIdGet[]
  - `sNextOfKinId` string
  - `sName` string
  - `sRelationship` string
  - `sContactNumber` string
  - `sComment` string
  - `objAddress` object
    - `sAddressType` string
    - `sCountryCode` string
    - `sProvince` string
    - `sAddressLine1` string
    - `sAddressLine2` string
    - `sCityTown` string
    - `sPostalCode` string
    - `co_ords` CoOrds: The geo-location information, co-ordinates
      - `longitude` number
      - `latitude` number
  - `id` string, required

## Other responses

- `204`: No Content. Returned if no next-of-kin details were found.
- `400`: Validation Error. Usually caused by a missing or invalid parameter. Or this could be because of an unexpected result returned from ACCR at the moment.
- `401`: Authorization Error. Thrown if the user does not have access to resource.
- `404`: Not found. Returned if no resource was found
- `405`: Method not supported Error. Returned if an unsupported http method is used.
- `default`: unexpected error

---

[API](https://skmtc.dev/staffshift/apis/staffshift-api-gateway.md) - [All operations](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/revisions/1f079f6b65f5?raw)