# Get Providers

> GET /v1/providers

`GET https://app.untetherlabs.com/api/v1/providers`

Retrieve providers with optional related data and pagination

This endpoint is paginated. See /using-the-api/pagination.

## Request

```bash
curl -X GET 'https://app.untetherlabs.com/api/v1/providers' \
  -H 'Authorization: Bearer $UNTETHER_API_KEY'
```

## Query parameters

- `status` (one of, default ["onboarding","active"])
  - Option 1: EmploymentStatus
  - Option 2: EmploymentStatus[]
- `email` (string) — Filter by (case-insensitive) email, * wildcards allowed
- `teamId` (one of) — Filter providers by team ID(s)
  - Option 1: uuid
  - Option 2: uuid[]
- `includeEnrollments` (boolean, default false) — Include enrollment data for each provider
- `includeSkills` (boolean, default false) — Include skills data for each provider
- `includeManager` (boolean, default false) — Include manager data for each provider
- `includeTeam` (boolean, default false) — Include team data for each provider
- `pageSize` (number, default 20, min 1, max 200)
- `cursor` (string)

## Response 200

- `items` (ProviderWithRelations[], required)
  - `name` (string | null, required, example "Bruce Wayne")
  - `email` (string, required, example "bruce.wayne@goodhealth.com")
  - `hireDate` (string | null, required, example "2024-11-20T07:43:34+0000")
  - `status` (enum, required, example "active", one of `onboarding`, `active`, `dismissed`, `unmanaged`)
  - `teamId` (uuid | null, required)
  - `licensedRegions` (string[], required)
  - `employmentType` (uuid | null, required)
  - `enrollments` (ProviderEnrollment[], required)
    - `name` (string, required)
  - `skills` (ProviderSkill[], required)
    - `skillName` (string, required)
    - `values` (string[], required)
  - `skillLicensedRegion` (string[])
  - `skillEnrollment` (string[])
  - `manager` (object | null, required)
    - `name` (string | null, required)
  - `team` (object | null, required)
    - `name` (string, required)
    - `shorthandName` (string | null, required)
- `cursor` (string)

## Errors

- `validation` (400) — Input validation failed.