---
title: "Batch practitioner data with licenses, DEA and CDS information"
method: GET
path: "/v2/providers/licenses"
tags: ["v2/providers"]
---

# Batch practitioner data with licenses, DEA and CDS information

`GET /v2/providers/licenses`

Fetches practitioners with licenses, DEA and CDS data using cursor-based pagination.
      This endpoint is designed for synchronizing practitioner data to downstream systems.
      Returns base practitioner fields plus all licenses, DEA and CDS dashboard fields.

## Query parameters

- `npi` string
- `size` number
- `cursor` string
- `cdsStatus` string
- `deaStatus` string
- `licenseStatus` string

## Headers

- `organization-id` string

## Response `200`

List of practitioners with licenses, DEA and CDS data.

- PractitionerEgressResponseDto
  - `data` PractitionerEgressDto[], required
    - `npi` string, required
    - `firstName` string, required
    - `lastName` string, required
    - `middleName` string
    - `providerType` string
    - `status` string, required
    - `states` string[]
    - `credentialingStatus` string, required
    - `licenses` PractitionerLicenseDto[]
      - `state` string, required
      - `licenseNumber` string, required
      - `type` string, required
      - `licenseStatus` string, required
      - `issueDate` string, date-time
      - `expirationDate` string, date-time, required
      - `source` string, required
    - `deaData` PractitionerDeaDto[]
      - `state` string, required
      - `licenseNumber` string, required
      - `type` string, required
      - `providerType` string, required
      - `expirationDate` string, date-time, required
      - `status` string, required
      - `source` string, required
      - `address1` string
      - `address2` string
      - `city` string
      - `zipCode` string
    - `cdsData` PractitionerDeaDto[]
      - `state` string, required
      - `licenseNumber` string, required
      - `type` string, required
      - `providerType` string, required
      - `expirationDate` string, date-time, required
      - `status` string, required
      - `source` string, required
      - `address1` string
      - `address2` string
      - `city` string
      - `zipCode` string
  - `nextCursor` string, nullable, required — Cursor for next page. Null when no more records exist.
  - `links` PractitionerEgressLinksDto, required
    - `self` string — URL for the current page
    - `next` string, nullable — URL for the next page. Null when no more records exist.

## Other responses

- `400` — Bad request - invalid cursor or size parameter.
- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.

---

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