Patients
Patient 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.
get/api/v2/patients/{particle_patient_id}/provider_map
Path parameters
particle_patient_idstring required
Example:ac82d365-97f9-4111-92fa-3a2b92744b12
Particle Patient ID
Response
OK
Example response
{
"particle_patient_id": "ac82d365-97f9-4111-92fa-3a2b92744b12",
"providers": [
{
"oid": "2.16.840.1.113883.3.789",
"organization_name": "Example Regional Medical Center",
"network": "CAREQUALITY",
"last_seen": "2025-12-15",
"active": true,
"type": "Practice",
"npi": "1234567890",
"address": "123 Health Ave",
"city": "Springfield",
"state": "IL",
"postal_code": "62701",
"lat": "39.799600",
"lng": "-89.644600",
"managing_organization_name": "Epic Systems",
"managing_organization_oid": "2.16.840.1.113883.3.123"
}
]
}