---
title: "List signed consent forms for a candidate"
method: GET
path: "/v1/candidates/{candidate_id}/consent_forms"
tags: ["Candidates"]
---

# List signed consent forms for a candidate

`GET /v1/candidates/{candidate_id}/consent_forms`

Retrieve all signed consent forms for a specific candidate. Returns up to 5 most recent consent forms ordered by signed date (most recent first). Useful for compliance requirements where you need to extract and store signed consent forms in external systems.

## Response `200`

successful

- object
  - `data` object[], required
    - `project_id` integer, required — The ID of the study/project where the consent form was signed
    - `project_title` string, required — The title of the study/project
    - `consent_form_id` integer, required — The ID of the consent form template
    - `participation_consent_form_id` integer, required — The unique ID of this signed consent form
    - `filename` string, nullable — The filename of the original consent form PDF
    - `signed_at` string, date-time, required — When the consent form was signed
    - `pdf_url` string, nullable — URL to download the signed consent form PDF
    - `can_download` boolean — Whether the current user can download the signed PDF

## Other responses

- `401` — unauthorized
- `404` — not found

---

[API](https://skmtc.dev/greatquestion/apis/api-reference-v1.md) · [All operations](https://skmtc.dev/greatquestion/apis/api-reference-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greatquestion/api-reference-v1/revisions/f263ec4858a6/schema)