# Get organization

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

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

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

Returns one organization (a zone in the Slim dashboard) by id. Use it to show or edit a zone.

**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 `Organization:read` (admins and super admins skip this check).
**Scope:** The organization is read with the caller's own token, so you get any organization your Ovok AccessPolicy lets you read. There is no extra project check on this route.

## Request [#request]

### Path parameters [#path-parameters]

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string (uuid)` | Yes | Organization (zone) id. |

## Behaviour [#behaviour]

- Read-only.
- `description` is the organization's narrative text with the XHTML `<div>` wrapper removed. It is absent when the organization has no narrative.
- `parentOrganizationId` is the id from `Organization.partOf`. It is absent for a top-level zone.

## Example [#example]

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


## Successful response [#successful-response]

`200` — Organization retrieved successfully.

```json
{
  "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21",
  "name": "Ward A",
  "parentOrganizationId": "1e6b8d30-2c4f-4a95-8d7e-b0a2c4e6f918",
  "description": "Ground floor"
}
```

| Field | Type | Description |
| --- | --- | --- |
| `id` | `string (uuid)` | Organization (zone) id. |
| `name` | `string` | Zone name. Empty string when the organization has no name. |
| `parentOrganizationId` | `string (uuid)` | Id of the parent zone. Left out for a top-level zone. |
| `description` | `string` | Narrative text without its XHTML wrapper. Left out when there is none. |

## 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 `Organization:read`, or the request is not authorized to read the organization. |
| [`404`](/errors/not-found) | No organization with this id exists. |
| [`422`](/errors/validation-failed) | `id` is not a UUID. |
