API Documentation

REST v1 reference. Authenticate with Authorization: Bearer … or X-API-Key.

Authentication

Authorization: Bearer vnhq_live_xxxxxxxxxxxx
# or
X-API-Key: vnhq_live_xxxxxxxxxxxx

Verticals

Path aliases: pa-np → paAndNp, pt-ot → ptOt.

doctor, therapist, nurse, dentist, pharmacist, paAndNp, ptOt, veterinarian, contractor, attorney, cosmetologist, massage_therapist, architect, engineer, real_estate, insurance

Verify by license number

GET/api/v1/verify/{vertical}/{state}?licenseNumber=…

curl -s 'https://www.verifynowhq.com/api/v1/verify/contractor/CA?licenseNumber=100001' \
  -H 'Authorization: Bearer vnhq_test_xxxxxxxx'

Verify by name (or number in body)

POST/api/v1/verify/{vertical}/{state}

curl -s -X POST 'https://www.verifynowhq.com/api/v1/verify/doctor/CA' \
  -H 'Authorization: Bearer vnhq_test_xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"lastName":"Smith","firstName":"John"}'

Bulk verify

POST/api/v1/verify/bulk

curl -s -X POST 'https://www.verifynowhq.com/api/v1/verify/bulk' \
  -H 'Authorization: Bearer vnhq_test_xxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"licenses":[{"vertical":"contractor","state":"CA","licenseNumber":"100001"}]}'

Dedicated vertical routes

/api/v1/doctor/{state}, /api/v1/nurse/{state}, /api/v1/dentist/{state}, …
/api/v1/pa-np/{state}, /api/v1/pt-ot/{state}, /api/v1/attorney/{state}
Bulk: /api/v1/{vertical}/bulk (e.g. /api/v1/doctor/bulk)

Health

GET/api/v1/health — no API key required.