---
search:
  tags:
    - participants
    - GET
seo:
  description: >-
    Organization-scoped participant read. Requires participants.read. Unknown…
    Reference for the GET /participants/{id} endpoint in the Soljio Organization
    API.
sidebar:
  label: Get participant
  badge: GET
title: Get participant
type: openapi-operation
---
Organization-scoped participant read. Requires participants.read. Unknown or repeated query parameters are rejected. Contact data, birth dates and private notes are omitted. Linked profiles follow provider consent.

`GET /participants/{id}`

**Responses**

- `200` — Successful operation.
- `400` — invalid\_request
- `401` — unauthorized
- `403` — forbidden
- `404` — not\_found
- `405` — method\_not\_allowed
- `429` — rate\_limited
- `500` — internal\_error

Response example, 200:

```json
{
  "data": {
    "id": "string",
    "organization_id": "string",
    "status": "string",
    "updated_at": "2019-08-24T14:15:22Z",
    "object": "participant",
    "created_at": "2019-08-24T14:15:22Z",
    "display_name": "string",
    "given_name": "string",
    "family_name": "string",
    "provider_link": {
      "status": "string",
      "consent_status": "string",
      "provider_visibility": "string"
    }
  },
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}
```

Response example, 400:

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The request is invalid."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 401:

```json
{
  "error": {
    "code": "unauthorized",
    "message": "A valid service token is required."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 403:

```json
{
  "error": {
    "code": "forbidden",
    "message": "The service token lacks a required scope."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 404:

```json
{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 405:

```json
{
  "error": {
    "code": "method_not_allowed",
    "message": "The method is not supported for this resource."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 429:

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the indicated delay."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```

Response example, 500:

```json
{
  "error": {
    "code": "internal_error",
    "message": "The request could not be completed."
  },
  "request_id": "00000000-0000-4000-8000-000000000001"
}
```
