Certifyos Practitioner API
Endpoints for managing practitioner information and associations.
Certifyos Practitioner API is one of 57 APIs that Certifyos publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Practitioner. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 52 operations across 43 paths, and defines 202 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.
Requests are made against 6 base URLs: http://localhost:9000, https://api-service.staging.certifyos.com, https://api-service.internal.certifyos.com, https://api-service.test.certifyos.com, https://api-service.demo.certifyos.com, https://api-service.certifyos.com.
52 operations
43 paths
202 schemas
2 DELETE12 GET8 PATCH6 POST24 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Certifyos Practitioner API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (JWT) (jwt).
jwt— JWT Authentication - Provide only the raw token without Bearer prefix
Paths & Operations 52
Across 43 paths, the API surfaces 52 operations — 2 DELETE, 12 GET, 8 PATCH, 6 POST, 24 PUT. Each is listed below with its method, path, parameters, and response codes.
Practitioner 52
Endpoints for managing practitioner information and associations.
GET
/practitioners
Find Practitioner by filter criteria with pagination
POST
/practitioners
Create a new practitioner
PUT
/practitioners/group-practitioner-location-network-specialties/effective-date
Update effective date of a practitioner location network specialty at group…
PATCH
/practitioners/group-practitioner-location-network-specialties/specialty
Correct the specialty at the practitioner-location-network level
PUT
/practitioners/group-practitioner-location-specialties/effective-date
Update effective date of a practitioner location specialty at group level
PATCH
/practitioners/group-practitioner-location-specialties/specialty
Correct the specialty at the practitioner-location level
PUT
/practitioners/group-practitioner-network-participation-specialties/effective-date
Update effective date of a practitioner network participation specialty at…
PUT
/practitioners/group-practitioner-specialties/effective-date
Update effective date of a practitioner specialty at group level
PATCH
/practitioners/practitioner-locations/{id}/roles/correct
Correct a practitioner role key on a group-practitioner-location record
PATCH
/practitioners/practitioner-locations/{id}/roles/remove
Remove a practitioner role at the location level
PUT
/practitioners/practitioner-role-assignments/{id}/terminate
Terminate a practitioner role at a network location assignment
PUT
/practitioners/tenant-practitioner-specialties
Update a tenant practitioner specialty
PATCH
/practitioners/tenant-practitioner-specialties/specialty
Correct the specialty on a tenant practitioner specialty record
PUT
/practitioners/tenant-practitioner-specialties/terminate
Terminate a tenant practitioner specialty with cascading support
PUT
/practitioners/terminate
Terminate practitioner from network/location/grouplocations
PUT
/practitioners/{certifyPractitionerId}/groups/{certifyGroupId}/effective-date
Update effective dates for practitioner-group association
PUT
/practitioners/{id}
Update a practitioner
GET
/practitioners/{id}
Get a practitioner value by their ID
PUT
/practitioners/{id}/board-certifications
Update or Delete board certifications for a practitioner
GET
/practitioners/{id}/core
Get core practitioner record by crosswalk ID
PUT
/practitioners/{id}/dea
Update or Delete DEA records for a practitioner
PUT
/practitioners/{id}/education-training
Update or delete education and training records for a practitioner
PUT
/practitioners/{id}/facilities
Update practitioner facility associations
PUT
/practitioners/{id}/licenses
Update or Delete licenses for a practitioner
PUT
/practitioners/{id}/networks
Update practitioner network associations
GET
/practitioners/{id}/networks
Get all the networks that the practitioner belongs to
POST
/practitioners/{id}/networks
Associate practitioner with a network
PUT
/practitioners/{id}/overview
Update practitioner overview information
GET
/practitioners/{id}/relationships/all
Get all the relationships of the practitioner
GET
/practitioners/{id}/relationships/groups
Get all the groups that the practitioner belongs to
GET
/practitioners/{id}/relationships/locations
Get all the locations that the practitioner belongs to
GET
/practitioners/{id}/relationships/networks
Get all the networks that the practitioner belongs to
PUT
/practitioners/{id}/roles
Update practitioner roles
PATCH
/practitioners/{id}/roles/correct
Correct a practitioner role key in data-correction mode
PATCH
/practitioners/{id}/roles/remove
Remove a practitioner role at the core level
PUT
/practitioners/{id}/ssn
Update practitioner SSN
PUT
/practitioners/{id}/supporting-documents
Update or Delete a supporting document for a practitioner
POST
/practitioners/{id}/supporting-documents
Create a new supporting document for a practitioner
GET
/practitioners/{practitionerId}/groups
Get groups for a practitioner
PUT
/practitioners/{practitionerId}/groups/{groupId}
Associate practitioner with a group
POST
/practitioners/{practitionerId}/groups/{groupId}/locations
Associate practitioner with group locations
GET
/practitioners/{practitionerId}/hospital-affiliations
List hospital affiliations for a practitioner
POST
/practitioners/{practitionerId}/hospital-affiliations
Create a hospital affiliation for a practitioner
PATCH
/practitioners/{practitionerId}/hospital-affiliations/{affiliationId}
Partially update a hospital affiliation
DELETE
/practitioners/{practitionerId}/hospital-affiliations/{affiliationId}
Delete a hospital affiliation
PUT
/practitioners/{practitionerId}/locations
Update practitioner location associations
GET
/practitioners/{practitionerId}/locations
Get locations for a practitioner
PUT
/practitioners/{practitionerId}/locations/{locationId}/networks/{networkId}
Update practitioner details at a location for a network or all networks
PUT
/practitioners/{practitionerId}/locations/{locationId}/networks/{networkId}/npi-par-date
Update NPI and Location NPI Participation Date for a practitioner at a…
GET
/practitioners/{practitionerId}/specialties
Get specialties for a practitioner
POST
/practitioners/{practitionerId}/specialties
Associate a practitioner with a specialty
DELETE
/practitioners/{practitionerId}/tenant-practitioner-specialties/{tpsId}
Permanently remove a practitioner specialty (hard delete with FK cascade)
Schemas 202
The contract defines 202 schemas that model the data the API accepts and returns. The most detailed are Practitioner.schema (179 properties), PractitionerGetResponse (82 properties), CorePractitionerdataschema (78 properties), CorePractitionerdatabaseschemaNpdbReportsInner (58 properties). Each schema is shown below with its type and property counts.
AssociatePractitionerGroupLocationsResponse
object
Response containing practitioner-group location associations
3 properties
OfficeHour
object
Operating hours for a specific day of the week
4 properties
SpecialtyAssociationLevel
string
CorePractitionerdatabaseschemaNpdbReportsInnerSubmitter
object
3 properties
AssociatePractitionerSpecialtyResponse
object
10 properties
TransformedNetworkData
object
7 properties
PractitionerGroupsResponse.schema
object
Response containing groups that a practitioner belongs to. Each group represents a group operational value with core group data and metadata.
3 properties
2 required
ApiError1
object
1 property
CorePractitionerdatabaseschemaNpdbReportsInnerCertification
object
4 properties
MdmExecutionSummary
object
4 properties
TenantPractitionerLocationResponseArray.schema
array
Array of location entities associated with a tenant practitioner, combining location registry and tenant location details.
CorePractitionerdatabaseschemaSiteVisitsInner
object
13 properties
CorePractitionerdatabaseschemaCaqhPdqsPractitionerProfessionalId
object
1 property
UpdatePractitionerNetworkRequest
object
Request to update a practitioner's association with a specific network
2 properties
1 required
CorePractitionerdatabaseschemaPracticeLocationsInner
object
34 properties
TenantPractitionerGroupResponse.schema
object
Represents a group entity associated with a tenant, combining group registry and tenant group details.
18 properties
3 required
UpdatePractitionerFacilityRequest
object
Request to update a practitioner's association with a specific facility
2 properties
1 required
PractitionerNetworkUpdateResponse
object
Response containing updated practitioner-network associations
2 properties
CorePractitionerdatabaseschemaSanctionsInner
object
19 properties
CorePractitionerdatabaseschemaProfessionalIdsInner
object
16 properties
CreateTenantGroupPractitionerRequest
object
1 property
CorrectPractitionerSpecialtyRequest
object
2 properties
2 required
CorePractitionerdatabaseschemaNppesInnerTaxonomiesInner
object
6 properties
CorePractitionerdatabaseschemaNppesInner
object
28 properties
UpdatePractitionerNetworksRequest
object
Request to update a practitioner's network associations
2 properties
2 required
CorrectLocationNetworkSpecialtyRequest
object
2 properties
2 required
TenantPractitionerGroupResponseArray.schema
array
Array of group entities associated with a tenant practitioner, combining group registry and tenant group details.
UpdatePractitionerLocationNpiParDateRequest
object
Request to update NPI and participation date for a practitioner at a location-network
3 properties
1 required
CorePractitionerdatabaseschemaNpdbReportsInnerOtherNameInner
object
2 properties
2 required
CorePractitionerdatabaseschemaCmsSpecialtiesInner
object
3 properties
PractitionerRoleCorrectionRequest
object
2 properties
2 required
UpdateGroupPractitionerSpecialtyEffectiveDateRequest
object
2 properties
2 required
TransformedLocationDetails
object
20 properties
Language
object
2 properties
1 required
CorePractitionerdatabaseschemaDisclosureQuestionsInner
object
8 properties
PractitionerLocationNetworkUpdateResponse
object
Response containing updated practitioner-location-network association
6 properties
DelegationStatusEnum2
string
GroupPractitionerNetworkData
object
7 properties
PractitionerMedicaidInner
object
20 properties
CorePractitionerdatabaseschemaAppVerificationsInner
object
13 properties
CorePractitionerdatabaseschemaEmailsInner
object
8 properties
MdmStepResult
object
7 properties
SpecialtyNotCreated
object
A specialty association that could not be created at this level, with reason and message
3 properties
3 required
TenantGroupLocationPractitionerNetworkResponse
object
7 properties
Date
string
Practitioner.schema
object
179 properties
UpdatePractitionerFacilitiesRequest
object
Request to update a practitioner's facility associations
2 properties
2 required
LocationAssociationResult
object
Result of a single location association
3 properties
DelegationStatusEnum
string
AccessibilityResponse
object
2 properties
JsonNodeType
string
BoardCertificationUpdateRequest1
object
14 properties
UpdateHospitalAffiliationRequest
object
Partial update payload (PATCH) for a practitioner-level hospital affiliation. All fields are optional.
8 properties
DeaUpdateRequest1
object
11 properties
DaysOfTheWeek.schema
string
A reusable enum schema defining the standard three-letter abbreviations for days of the week.
CorrectLocationSpecialtyRequest
object
2 properties
2 required
PractitionerRolesUpdateResponse
object
Practitioner roles update response
2 properties
UpdatePractitionerGroupEffectiveDateRequest
object
4 properties
PractitionerBusinessPurposeIsForCredentialing
object
2 properties
TerminatePractitionerRoleResponse
object
3 properties
AssociatePractitionerGroupLocationsRequest
object
Request to associate a practitioner with group locations
3 properties
2 required
MdmErrorDetail
object
3 properties
CorePractitionerdatabaseschemaWorkHistoryGapsInner
object
7 properties
OfficeHours2
object
3 properties
PractitionerBusinessPurposeIsForMonitoring
object
2 properties
CorePractitionerdatabaseschemaCaqhPdqsPractitionerSpecialty
object
1 property
TenantGroupPractitionerNetworkResponse
object
5 properties
TenantGroupPractitionerResponse
object
5 properties
UpdateGroupPractitionerLocationNetworkSpecialtyEffectiveDateRequest
object
2 properties
2 required
CorePractitionerdatabaseschemaCaqhPdqsPractitionerProfessionalIdPractitionerEcfmg
object
2 properties
MdmProcessStatus
string
NetworkAssociationResult3
object
Result of a single network association update
3 properties
UpdateStatus
string
Status of an update operation
CorePractitionerdatabaseschemaEducationInner
object
3 properties
PractitionerRolesMapValue
object
2 properties
CorePractitionerdatabaseschemaBoardCertificationsInner
object
33 properties
TypeEnum
string
UpdateTenantPractitionerSpecialtyRequest
object
2 properties
2 required
CorePractitionerdatabaseschemaXRayLicensesInner
object
3 properties
GroupPractitionerSpecialtyTermination
object
7 properties
1 required
TenantGroupLocationParticipationSpecialtyResponse
object
4 properties
TransformedPractitionerRelationships
object
10 properties
AssociatePractitionerNetworkRequest
object
Request to associate a practitioner with a network
4 properties
2 required
TenantGroupLocationPractitionerNetwork.schema
object
Represents the participation of a tenant group location practitioner in a specific plan.
19 properties
HospitalAffiliationSourceType
string
Source-of-truth tag for a practitioner-level hospital affiliation. Accepts MANUAL, ROSTER, CAQH (any case), or the legacy long-form CAQH label. Always serializ…
LocationNetwork2
object
Network association for a practitioner at a specific location
2 properties
1 required
CorePractitionerdatabaseschemaPracticeLocationsInnerLocationHoursInner
object
3 properties
PractitionerAddressesInner
object
13 properties
NetworkAssociationResult2
object
Result of a network association at a specific location
2 properties
CorePractitionerdatabaseschemaMalpracticeInsuranceInner
object
21 properties
PracticeLimitation2
object
2 properties
TenantGroupLocationSpecialtyResponse
object
4 properties
TenantPractitionerLocationResponse.schema
object
Combined schema representing a practitioner's location within a tenant group, including all location details, tenant group associations, and practitioner-speci…
30 properties
RoleType.schema
string
Defines the possible roles for a practitioner at a location.
LocalDate
string
TerminatePractitionerRoleRequest
object
4 properties
2 required
JsonNode
object
22 properties
CorePractitionerdatabaseschemaNpdbReportsInnerMaintainedUnder
object
1 property
SsnUpdateRequest
object
1 property
1 required
CorePractitionerdatabaseschemaPhoneNumbersInner
object
9 properties
PractitionerRelationshipGroup
object
12 properties
LocationNetwork3
object
Network association for a practitioner at a specific location
2 properties
1 required
TransformedGroup
object
16 properties
PractitionerGetResponse
object
82 properties
TenantPractitionerSpecialtyJoinResponseArray.schema
array
Array of specialty entities associated with a tenant practitioner, combining specialty registry and tenant practitioner specialty details.
GetPractitionerSpecialtyResponse
object
1 property
NetworkResponse1
object
4 properties
MdmProcessResponse
object
7 properties
SpecialtyNotCreatedReason
string
PagedPractitionerGetResponse
object
2 properties
TenantPractitionerSpecialty.schema
object
Represents the specialty information for a healthcare provider. References the Specialty entity.
3 properties
3 required
TransformedSpecialtyData
object
11 properties
PractitionerCreateResponse
object
3 properties
RemovePractitionerRoleRequest
object
1 property
1 required
TenantGroupPractitionerLocationNetworkSpecialtyResponse
object
4 properties
FacilityAssociationResult
object
Result of a single facility association update
3 properties
HospitalAffiliationResponse
object
Practitioner-level hospital affiliation as exposed by the practitioner CRUD API.
9 properties
1 required
ErrorObject1
object
4 properties
DayOfWeekEnum
string
TenantPractitionerSpecialtyResponse
object
6 properties
CorePractitionerdatabaseschemaNppesInnerAddressesInner
object
10 properties
CorePractitionerdatabaseschemaDeaInner
object
24 properties
AddressType.schema
string
Defines the address type for a location.
UpdatePractitionerLocationNetworkRequest
object
Request to update practitioner details at a location for a network
3 properties
1 required
NetworkUpdateResult
object
Result of updating a single network
3 properties
CoreGroupOperationalValue.data.base.schema
object
Foundation schema defining properties for core group operational value data.
11 properties
CorePractitionerdatabaseschemaLicensesInner
object
27 properties
UpdateGroupPractitionerLocationSpecialtyEffectiveDateRequest
object
2 properties
2 required
CreateHospitalAffiliationRequest
object
Create payload for a practitioner-level hospital affiliation.
8 properties
2 required
Attachment1
object
9 properties
PractitionerSpecialtyTerminationRequest
object
5 properties
2 required
PractitionerBusinessPurpose
object
2 properties
GetPractitionerLocationResponse
object
1 property
NetworkAssociationResult1
object
Result of a network association at a specific location
2 properties
LocationContact3
object
7 properties
CorePractitionerdatabaseschemaCaqhPdqsPractitionerSpecialtyOtherSpecialty
object
1 property
CorePractitionerdatabaseschemaLicensureActionsInner
object
19 properties
AdaCompliance
object
Americans with Disabilities Act compliance details
3 properties
CorePractitionerdatabaseschemaHospitalAffiliationsInner
object
19 properties
CorePractitionerdatabaseschemaCliaCertificatesInner
object
3 properties
CorePractitionerdatabaseschemaMedicareInner
object
18 properties
TransformedNetwork
object
5 properties
DelegationStatus
string
Delegation status of the practitioner
CorePractitionerdataschema
object
78 properties
CorePractitionerdatabaseschemaEducationTrainingInner
object
20 properties
CorePractitionerdatabaseschemaNpdbReportsInner
object
58 properties
SanctionsLineageValue
object
7 properties
PractitionerRoleUpdateRequest
object
Individual practitioner role update request
4 properties
1 required
TransformedAddress
object
8 properties
TransformedNetworkDetails
object
10 properties
CorePractitionerResponse
object
15 properties
CorePractitionerdatabaseschemaCdsInner
object
20 properties
CorePractitionerdatabaseschemaCaqhPdqs
object
6 properties
OverviewUpdateRequest
object
23 properties
PractitionerLocationUpdateResponse
object
Response containing updated practitioner-location associations
2 properties
Status.schema
string
The possible statuses for a various entities.
CreatePractitionerRequest
object
1 property
GroupOVResponse
object
Represents a group operational value that the practitioner belongs to. Contains the group's core identifiers, operational data, and contributing slice informat…
4 properties
2 required
CorePractitionerdatabaseschemaSpecialtiesInner
object
21 properties
TerminationRequest
object
15 properties
4 required
TaxInfo.schema
object
Represents the legal tax entity information associated with a group.
4 properties
4 required
PractitionerResponse
object
10 properties
SupportingDocumentUpdateRequest2
object
8 properties
1 required
CoreFacilitydataschemaNppesInnerIdentifiersInner
object
4 properties
CorePractitionerdatabaseschemaNpdbReportsInnerEnrollmentStatus
object
8 properties
CorePractitionerdatabaseschemaMalpracticeInsurancesInner
object
18 properties
AffiliationType.schema
string
Defines the possible affiliation types
PageLinks-2
object
Navigation links for the response
3 properties
1 required
LicenseUpdateRequest1
object
10 properties
PractitionerSpecialty
object
11 properties
CreateTenantPractitionerSpecialtyRequest
object
12 properties
TransformedSpecialty
object
20 properties
TenantGroupPractitionerSpecialtyResponse
object
4 properties
ContactType.schema
string
Specifies the different types of contact points for healthcare providers.
TenantGroupPractitionerLocation.schema
object
Represents the association of a practitioner details at a specific location within a tenant group, including role, availability, and effective dates.
33 properties
GroupPractitionerLocationSpecialtyResponse
object
4 properties
AssociatePractitionerNetworkResponse
object
Response containing practitioner-network association result
4 properties
GroupPractitionerNetwork
object
6 properties
GetPractitionerGroupResponse
object
1 property
GroupPractitionerLocationResponse1
object
4 properties
PractitionerFacilityUpdateResponse
object
Response containing updated practitioner-facility associations
2 properties
PanelStatus.schema
string
Specifies the panel status (patient acceptance status) of the practitioner at the location.
UpdateGroupPractitionerNetworkParticipationSpecialtyEffectiveDateRequest
object
2 properties
2 required
CorePractitionerdatabaseschemaPracticeLocationsInnerLocationAccessibility
object
12 properties
UpdatePractitionerLocationsRequest
object
Request to create or update a practitioner's location associations. Use the same endpoint to edit existing location data (e.g. update NPI(s)). Each location's…
2 properties
2 required
GroupLocationAssociation
object
Request to associate a practitioner with a specific group location
3 properties
1 required
UpdatePractitionerLocationRequest
object
Request to update a practitioner's association with a specific location
3 properties
1 required
GroupLocationTypes.schema
string
Defines the various types of healthcare facilities and services that can be associated with a group.
CorePractitionerdatabaseschemaResidencyInner
object
2 properties
EducationTrainingUpdateRequest1
object
11 properties
LocationAssociationResult1
object
Result of a single location association update
4 properties
attachment
object
9 properties
PractitionerLocationNetworksUpdateResponse
object
Response containing updated practitioner-location-network associations for multiple networks
4 properties
TransformedLocation
object
7 properties
CorePractitionerdatabaseschemaPerformanceIndicatorsInner
object
15 properties
ClassificationSourceEnum
string
TenantGroupPractitioner.schema
object
Represents the association of a practitioner with a tenant group.
4 properties
TenantPractitionerSpecialtyJoinResponse.schema
object
Represents a specialty entity associated with a tenant practitioner, combining specialty registry and tenant practitioner specialty details.
17 properties
3 required
CorePractitionerdatabaseschemaNpdbReportsInnerCertificationPhone
object
1 property
TransformedLocationData
object
4 properties
EntityContacts.schema
object
A reusable schema for storing standardized contact information including phone numbers, email, and contact type.
5 properties
CorePractitionerdatabaseschemaLanguagesInner
object
3 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Certifyos 12
Other APIs Certifyos publishes across the network.
Certifyos Address Standardization API
Certifyos Auth API
Certifyos Auth Tokens API
Certifyos Contracts API
Certifyos Credentialing Outreach Resource API
Certifyos Credentialing Workflows API
Certifyos Credentialing Workflow API
Certifyos Dal Reactive Test Resource API
Certifyos Directory API
Certifyos Egress Template API
Certifyos Event Email Settings API
Certifyos Facility API
#Practitioner
Where this information came from
This is an independent, third-party profile of Certifyos Practitioner API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.