Physicians

The Physicians resource represents referring physicians and clinicians. Physicians are read-only — they cannot be created or modified via the API.

Endpoints

Method	Path	Description
GET	/Physicians	List physicians
GET	/Physicians({id})	Get a single physician

List Physicians

GET /Physicians

Supports: $filter, $select, $orderby, $top, $skip, $count, $expand

Example

curl -X GET "https://api.nymblqa.com/Physicians?\$filter=active eq true&\$orderby=last_name asc" \
  -H "Authorization: Bearer eyJraWQiOiJ..." \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "@odata.context": "https://api.nymblqa.com/$metadata#Physicians",
  "@odata.count": 42,
  "value": [
    {
      "id": "phys-001",
      "first_name": "Robert",
      "last_name": "Adams",
      "credentials": "MD",
      "npi": "1234567890",
      "active": true
    }
  ]
}

Get a Single Physician

GET /Physicians({id})

Example

curl -X GET "https://api.nymblqa.com/Physicians(phys-001)" \
  -H "Authorization: Bearer eyJraWQiOiJ..." \
  -H "x-api-key: YOUR_API_KEY"

Properties

Property	Type	Max Length	Description
id	string	—	Unique physician identifier (required)
active	boolean	—	Whether the physician record is active
first_name	string	25	First name
middle_name	string	25	Middle name
last_name	string	25	Last name
suffix	string	5	Name suffix (e.g., Jr., III)
credentials	string	20	Professional credentials (e.g., MD, DO, PhD)
email	string	40	Email address
npi	string	15	National Provider Identifier
upin	string	15	Unique Physician Identification Number
license_number	string	15	State medical license number
medicaid_number	string	15	Medicaid provider number
taxonomy_code	string	45	Provider taxonomy code
pecos_verified	boolean	—	Whether verified in PECOS system
verified_on	string	—	Date of PECOS verification
other_id1	string	15	Additional identifier 1
other_id2	string	15	Additional identifier 2
street_address	string	100	Office street address
city	string	30	City
state	string	2	State abbreviation
zipcode	string	10	ZIP code
hospital_facility	string	255	Associated hospital or facility
notes	string	—	General notes
alert_message	string	500	Alert message for staff
source_id	string	—	Source system record ID
source_name	string	100	Source system name

Common Query Examples

Active physicians, alphabetical:

GET /Physicians?$filter=active eq true&$orderby=last_name asc,first_name asc

Search by last name:

GET /Physicians?$filter=startswith(last_name,'Adams')

Lookup by NPI:

GET /Physicians?$filter=npi eq '1234567890'

PECOS-verified physicians:

GET /Physicians?$filter=pecos_verified eq true&$select=id,first_name,last_name,npi,credentials