---
title: "List Providers"
method: GET
path: "/admin/providers/list"
tags: ["provider", "admin"]
---

# List Providers

`GET /admin/providers/list`

Get a list of all providers

## Query parameters

- `include_decoda` boolean
- `location_id` string, nullable

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- FirebaseProviderSummary[]
  - `id` string, required — The unique identifier for the user.
  - `firstName` string, nullable — The user's first name.
  - `lastName` string, nullable — The user's last name.
  - `phoneNumber` string, nullable — The user's phone number.
  - `email` string, nullable — The user's email address.
  - `type` string, required — Type of the user, fixed as 'provider'.
  - `locationId` string, nullable — The location of the user.
  - `externalId` string, nullable — The user's external identifier if available.
  - `address` string, nullable — The user's primary address.
  - `addressLineTwo` string, nullable — Additional address information.
  - `city` string, nullable — The city of the user's address.
  - `state` string, nullable — The state of the user's address.
  - `zipCode` string, nullable — The postal code of the user's address.
  - `country` string, nullable — The country of the user's address.
  - `createdDate` string, date-time, required — The date and time when the user was created.
  - `addressValid` boolean, nullable — Whether the user's address is valid.
  - `meta` object, nullable — Any additional metadata about the user relevant to your system.
  - `isArchived` boolean, nullable — Whether the user is archived.
  - `primaryLocationId` string, nullable — Primary location id of the provider.
  - `roles` RoleSummary[], required — List of roles associated with the provider.
    - `id` string, required — Unique identifier for the role
    - `name` string, required — Role name (e.g., 'admin', 'user', 'billing_manager')
    - `userType` 'ADMIN' | 'PROVIDER' | 'USER', required
    - `createdDate` string, date-time, nullable — When the role was created
    - `updatedDate` string, date-time, nullable — When the role was last updated
  - `lastActive` string, date-time, nullable — Last active date of the provider.
  - `bio` string, nullable — Bio of the provider.
  - `profileImage` string, nullable — Profile image of the provider.
  - `hasGoogleCalendar` boolean — Whether the provider has a Google Calendar.
  - `nationalProviderIdentifier` string, nullable — National provider identifier of the provider.
  - `bookingCapacity` integer, nullable — Booking capacity of the provider.
  - `showIds` boolean — Whether to show IDs in the UI for this provider.
  - `showWeekendsOnCalendar` boolean — Whether to show weekends on the calendar for this provider.
  - `showCancelledAppointments` boolean — Whether to show cancelled appointments in the calendar for this provider.
  - `showMessagesBox` boolean — Whether to show the messages box in the UI for this provider.
  - `startCalendarHour` integer, nullable — The start hour of the calendar for this provider.
  - `endCalendarHour` integer, nullable — The end hour of the calendar for this provider.
  - `sendGcalInvites` boolean — Whether to send Google Calendar invites.
  - `calendarGridInterval` integer, nullable — Grid interval in minutes for calendar display.
  - `appointmentTimeStepMinutes` integer, nullable — Time step interval in minutes for appointment scheduling. If null, uses the smallest service duration.
  - `showTranslucentPastEvents` boolean — Whether to show translucent past events in the calendar for this provider.
  - `showGhostEvent` boolean — Whether to show ghost events on hover in the calendar for this provider.
  - `autoSignOffNotes` boolean — Whether notes should automatically sign off when created.
  - `firebaseUid` string, nullable — Firebase unique identifier for the provider.
  - `visibleLocationIds` string[] — List of location IDs that the provider can see.
  - `permissions` string[] — List of permissions associated with the provider.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)