---
title: "Perform a matchback operation to retrieve a pre-populated TeacherTrainingAdviserSignUp for the candidate."
method: POST
path: "/api/teacher_training_adviser/candidates/matchback"
tags: ["Teacher Training Adviser"]
---

# Perform a matchback operation to retrieve a pre-populated TeacherTrainingAdviserSignUp for the candidate.

`POST /api/teacher_training_adviser/candidates/matchback`

Attempts to matchback against a known candidate and returns a pre-populated TeacherTrainingAdviser sign up if a match is found.

## Request body

- ExistingCandidateRequest
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `email` string, email, required
  - `dateOfBirth` string, date-time, nullable
  - `reference` string, nullable

## Response `200`

OK

- TeacherTrainingAdviserSignUp
  - `degreeStatusId` integer, nullable
  - `candidateId` string, uuid, nullable
  - `qualificationId` string, uuid, nullable
  - `subjectTaughtId` string, uuid, nullable
  - `pastTeachingPositionId` string, uuid, nullable
  - `preferredTeachingSubjectId` string, uuid, nullable
  - `countryId` string, uuid, required
  - `acceptedPolicyId` string, uuid, required
  - `typeId` integer, required
  - `ukDegreeGradeId` integer, nullable
  - `degreeTypeId` integer, nullable
  - `initialTeacherTrainingYearId` integer, nullable
  - `stageTaughtId` integer, nullable
  - `preferredEducationPhaseId` integer, nullable
  - `hasGcseMathsAndEnglishId` integer, nullable
  - `hasGcseScienceId` integer, nullable
  - `planningToRetakeGcseMathsAndEnglishId` integer, nullable
  - `planningToRetakeGcseScienceId` integer, nullable
  - `adviserStatusId` integer, nullable
  - `channelId` integer, nullable
  - `degreeCountry` string, uuid, nullable
  - `creationChannelSourceId` integer, nullable
  - `creationChannelServiceId` integer, nullable
  - `creationChannelActivityId` integer, nullable
  - `email` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `dateOfBirth` string, date, required
  - `teacherId` string, nullable
  - `degreeSubject` string, nullable
  - `addressTelephone` string, nullable
  - `addressPostcode` string, nullable
  - `phoneCallScheduledAt` string, date-time, nullable
  - `canSubscribeToTeacherTrainingAdviser` boolean
  - `assignmentStatusId` integer, nullable
  - `defaultContactCreationChannel` integer, nullable
  - `defaultCreationChannelSourceId` integer, nullable
  - `defaultCreationChannelServiceId` integer, nullable
  - `defaultCreationChannelActivityId` integer, nullable
  - `graduationYear` integer, nullable
  - `inferredGraduationDate` string, date-time, nullable
  - `situation` integer, nullable
  - `citizenship` integer, nullable
  - `visaStatus` integer, nullable
  - `location` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/department-for-education/apis/get-into-teaching-api-v1.md) · [All operations](https://skmtc.net/department-for-education/apis/get-into-teaching-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/department-for-education/get-into-teaching-api-v1/revisions/5d53dbaed560/schema)