---
title: "Get User Participants with Details (POST)"
method: POST
path: "/api/v1/participant_info/user-participants"
---

# Get User Participants with Details (POST)

`POST /api/v1/participant_info/user-participants`

Get detailed participant information for all participants a user has access to using POST request body, including permissions, plan info, and plan manager details.

## Request body

- AppSchemasParticipantInfoUserIdRequest — Request model with user ID.
  - `user_id` string, required — User ID

## Response `200`

Successful Response

- UserParticipantsResponse — Response model for user participants.
  - `participants` UserParticipant[], required — List of participants accessible by the user
    - `user_id` string, required — User ID
    - `id` string, required — Participant ID
    - `first_name` string, required — Participant's first name
    - `last_name` string, required — Participant's last name
    - `participant_number` union, required — Participant number
      - string
      - integer
    - `user_email` string, required — User's email address
    - `address_line_1` string, nullable — Participant's address line 1
    - `city` string, nullable — Participant's city
    - `postcode` string, nullable — Participant's postcode
    - `service_region_id` string, nullable — Service region ID
    - `date_of_birth` string, date, nullable — Participant's date of birth
    - `plan_manager` string, nullable — Plan manager ID
    - `plan_manager_company_name` string, nullable — Plan manager company name
    - `plan_start_date` string, date, nullable — Plan start date
    - `plan_end_date` string, date, nullable — Plan end date
    - `is_pace_plan` boolean, nullable — Whether this is a pace plan
    - `advanced_view` boolean, required — Whether advanced view is enabled
    - `permission_id` string[], required — List of permission IDs (UUIDs)
    - `permission_names_friendly` string[], required — List of friendly permission names
  - `total_participants` integer, required — Total number of participants

## Other responses

- `400` — Bad request
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/caresquare/apis/fastapi.md) · [All operations](https://skmtc.dev/caresquare/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/caresquare/apis/fastapi/revisions/12dd4779f835?raw)
