---
title: "Retrieves the Metadata for agency candidate"
method: GET
path: "/agency/{agency_id}/candidate/{candidate_id}/meta"
tags: ["Agency Candidate Meta"]
---

# Retrieves the Metadata for agency candidate

`GET /agency/{agency_id}/candidate/{candidate_id}/meta`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/agency/{agency_id}/candidate/{candidate_id}/meta`
- Auth: HTTP basic and HTTP basic and HTTP basic

Retrieve Agency Candidate metadata record

## Response `200`

Agency Candidate metadata response

- AgencyCandidateMetaRetrieval
  - `_id` string, required
  - `updated_at` string, date-time, required
  - `created_at` string, date-time, required
  - `__v` integer, required
  - `agency_id` string, required
  - `candidate_id` string, required
  - `username` string
  - `user_id` string
  - `external_documents` ExternalDocumentsItem[]
    - `name` string, required
    - `type_id` string, required
    - `date` string, date-time, required
    - `expiry_date` string, date-time
  - `external_portfolios` AgencyExternalPortfoliosItem[]
    - `portfolio_id` string, required
    - `consultant_type_id` string, required
    - `consultant_id` string, required
    - `played_keywords` boolean, required
  - `external_verifications` ExternalVerificationsItem[]
    - `name` string, required
    - `type_id` string, required
    - `value` 'Yes' | 'No', required
  - `external_days_to_expiry` ExternalDaysToExpiryItem[]
    - `name` string, required
    - `type_id` string, required
    - `value` string, date-time
  - `external_workforce` string

## Other responses

- `400`: Agency candidate metadata validation errors
- `401`: Failed to authenticate the user making the request
- `403`: Permission denied error
- `404`: Resource not found
- `default`: Server error occurred

---

[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)