# Get practitioner

Canonical page: https://docs.ovok.com/slim-apis/practitioner/get-practitioner

| Method | Path |
| --- | --- |
| `GET` | `/v1/slim/practitioner/:id` |

[Authentication](/authentication) · [Access policies](/access-policies)

Returns a practitioner profile by id. Use it to show your own profile or, with the extra permission, another practitioner's.

**Auth:** Bearer token. The caller must be a practitioner, an admin, a super admin, or hold the "System Owner" access policy. The access policy must grant `Practitioner:read`. Reading another practitioner's profile also needs `Practitioner:update`. Admins and super admins skip the access-policy check.
**Scope:** Your own profile is always readable. Another practitioner must belong to your project, one of its sub-projects, or its parent project.

## Request [#request]

### Path parameters [#path-parameters]

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes | Practitioner id. |

## Behaviour [#behaviour]

- Read-only.
- Your own profile is read with your token. Another practitioner's profile is read with Ovok's admin client after the project check above passes.

## Example [#example]

```bash
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/practitioner/3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"
```

## Successful response [#successful-response]

`200` — Practitioner profile retrieved successfully.

```json
{
  "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21",
  "name": "Anna",
  "surname": "Beispiel",
  "email": "team@example.com",
  "phone": "+4930123456789"
}
```

| Field | Type | Description |
| --- | --- | --- |
| `id` | `string (uuid)` | Practitioner id. |
| `name` | `string` | Given names of the official name, joined by a space. Left out when not set. |
| `surname` | `string` | Family name. Left out when not set. |
| `email` | `string` | Email address. Left out when not set. |
| `phone` | `string` | Phone number. Left out when not set. |
| `address` | `object` | First address. Left out when not set. |
| `address.line` | `string` | Street lines joined by a space. Left out when not set. |
| `address.city` | `string` | City. Left out when not set. |
| `address.state` | `string` | State. Left out when not set. |
| `address.postalCode` | `string` | Postal code. Left out when not set. |
| `address.country` | `string` | Country. Left out when not set. |
| `photo` | `string` | URL of the first photo. Left out when not set. |
| `meta` | `object` | Left out when the profile records no author. |
| `meta.author` | `string` | Reference to whoever last wrote the profile through Ovok, such as `Practitioner/<id>`. |

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| [`401`](/errors/unauthenticated) | Bearer token is missing, invalid or expired. |
| [`403`](/errors/forbidden) | You are not a practitioner, admin or System Owner, you lack `Practitioner:read` (plus `Practitioner:update` for someone else's profile), or the practitioner's project is outside your project tree. |
| [`404`](/errors/not-found) | No practitioner with this id exists, or it has no project. |
