{"openapi":"3.0.3","info":{"title":"VerifyNowHQ API","description":"Professional license verification — one API across verticals and US states.","version":"1.0.0","contact":{"name":"VerifyNowHQ","url":"https://www.verifynowhq.com"}},"servers":[{"url":"https://www.verifynowhq.com","description":"Current host"}],"tags":[{"name":"Health"},{"name":"Verify"},{"name":"Vertical"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Authorization: Bearer vnhq_live_…"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"X-API-Key: vnhq_live_…"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string"}}},"VerifyMeta":{"type":"object","properties":{"requestId":{"type":"string"},"responseTimeMs":{"type":"number"},"apiVersion":{"type":"string","example":"v1"}}}}},"security":[{"bearerAuth":[]},{"apiKeyHeader":[]}],"paths":{"/api/v1/health":{"get":{"tags":["Health"],"summary":"Health check","security":[],"responses":{"200":{"description":"Service healthy"},"503":{"description":"Service unhealthy"}}}},"/api/v1/verify/{vertical}/{state}":{"get":{"tags":["Verify"],"summary":"Verify by license number","parameters":[{"name":"vertical","in":"path","required":true,"schema":{"type":"string","enum":["doctor","therapist","nurse","dentist","pharmacist","paAndNp","ptOt","veterinarian","contractor","attorney","cosmetologist","massage_therapist","architect","engineer","real_estate","insurance"]},"description":"doctor | nurse | dentist | therapist | pharmacist | paAndNp (or pa-np) | ptOt (or pt-ot) | veterinarian | contractor | attorney | …"},{"name":"state","in":"path","required":true,"schema":{"type":"string","minLength":2,"maxLength":2},"example":"CA"},{"name":"licenseNumber","in":"query","required":true,"schema":{"type":"string"}},{"name":"licenseType","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verification result"},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited or quota exceeded"}}},"post":{"tags":["Verify"],"summary":"Verify by number, name, or NPI (healthcare)","parameters":[{"name":"vertical","in":"path","required":true,"schema":{"type":"string","enum":["doctor","therapist","nurse","dentist","pharmacist","paAndNp","ptOt","veterinarian","contractor","attorney","cosmetologist","massage_therapist","architect","engineer","real_estate","insurance"]}},{"name":"state","in":"path","required":true,"schema":{"type":"string","minLength":2,"maxLength":2}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"licenseNumber":{"type":"string"},"licenseType":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"npiNumber":{"type":"string"},"deaNumber":{"type":"string"},"businessName":{"type":"string"},"city":{"type":"string"}}},"examples":{"byNumber":{"value":{"licenseNumber":"A12345"}},"byName":{"value":{"lastName":"Smith","firstName":"John"}}}}}},"responses":{"200":{"description":"Verification or search result"},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}}}},"/api/v1/verify/bulk":{"post":{"tags":["Verify"],"summary":"Bulk verify licenses","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["licenses"],"properties":{"licenses":{"type":"array","items":{"type":"object","required":["vertical","state","licenseNumber"],"properties":{"vertical":{"type":"string","enum":["doctor","therapist","nurse","dentist","pharmacist","paAndNp","ptOt","veterinarian","contractor","attorney","cosmetologist","massage_therapist","architect","engineer","real_estate","insurance"]},"state":{"type":"string"},"licenseNumber":{"type":"string"},"licenseType":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"Bulk verification results"},"401":{"description":"Unauthorized"}}}},"/api/v1/doctor/{state}":{"get":{"tags":["Vertical"],"summary":"Doctor verify (dedicated route)","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string"}},{"name":"licenseNumber","in":"query","schema":{"type":"string"}},{"name":"npiNumber","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Doctor verification result"}}}},"/api/v1/nurse/{state}":{"get":{"tags":["Vertical"],"summary":"Nurse verify (dedicated route)","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string"}},{"name":"licenseNumber","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Nurse verification result"}}}},"/api/v1/pa-np/{state}":{"get":{"tags":["Vertical"],"summary":"PA/NP verify (kebab path alias for paAndNp)","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string"}},{"name":"licenseNumber","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"PA/NP verification result"}}}},"/api/v1/pt-ot/{state}":{"get":{"tags":["Vertical"],"summary":"PT/OT verify (kebab path alias for ptOt)","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string"}},{"name":"licenseNumber","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"PT/OT verification result"}}}},"/api/v1/attorney/{state}":{"get":{"tags":["Vertical"],"summary":"Attorney verify (dedicated route)","parameters":[{"name":"state","in":"path","required":true,"schema":{"type":"string"}},{"name":"barNumber","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Attorney verification result"}}}}}}