---
title: "Patient Provider Map"
method: GET
path: "/api/v2/patients/{particle_patient_id}/provider_map"
tags: ["Patients"]
---

# Patient Provider Map

`GET /api/v2/patients/{particle_patient_id}/provider_map`

Returns the set of healthcare organizations associated with given patient across Particle's network. Each entry represents an endpoint organization enriched with directory information (NPI, address, managing organization). Returns an empty `providers` array if no records are found.This endpoint requires the Patient Provider Map feature to be enabled for your project. Reach out to your Particle Health representative to get set up.

## Path parameters

- `particle_patient_id` string, required

## Response `200`

OK

- ApiProviderListResponse
  - `particle_patient_id` string
  - `providers` ApiProviderDirectoryEntry[]
    - `oid` string, required — Organization Identifier (OID) for the endpoint
    - `organization_name` string, required — Name of the endpoint organization
    - `network` string, required — Network source. Either CAREQUALITY or EHEALTHEXCHANGE
    - `last_seen` string, required — Most recent date a record was observed for this patient at this organization (YYYY-MM-DD)
    - `active` boolean — Whether the endpoint is currently active in the directory
    - `type` string — Organization type (e.g., Practice, Implementer)
    - `npi` string — National Provider Identifier for the organization
    - `address` string — Street address
    - `city` string — City
    - `state` string — State abbreviation
    - `postal_code` string — ZIP code
    - `lat` string — Latitude coordinate
    - `lng` string — Longitude coordinate
    - `managing_organization_name` string — Name of the managing (implementing) organization behind the endpoint
    - `managing_organization_oid` string — OID of the managing organization

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/particlehealth/apis/particle-health-api.md) · [All operations](https://skmtc.net/particlehealth/apis/particle-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/particlehealth/particle-health-api/revisions/5aead0b7515e/schema)