latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Practitioner

Manage licenses for a practitioner

Updates, creates, or deletes license records for the specified practitioner; supply an array of license items where each item includes an action field indicating the operation to perform (create, update, or delete). Use this to synchronize a practitioner's professional licenses — adding newly issued licenses, modifying existing license details such as state, expiration, or status, or removing licenses that are no longer valid. {id} is the certifyPractitionerId. Submitting an empty array wholesale-clears the entire licenses section with no confirmation step — there is no null/empty guard on this endpoint.

put/practitioners/{id}/licenses

Path parameters

idstring required

Practitioner ID

Headers

tenant-idstring

Request body

expirationstring date
issueDatestring date
licenseNumberstring

License number

statestring

State where the license is issued

licenseTypestring

Type of medical license

licenseStatusstring

Status of the license

licenseSourcestring

Source of the license data

reportDatestring date
licenseNumberVariationsstring

Alternative license number formats

actionstring

Action to perform on this license record (create, update, delete)

Example request

[
  {
    "licenseNumber": "MD12345",
    "state": "CA",
    "licenseType": "Medical Doctor",
    "licenseStatus": "Active",
    "licenseSource": "State Medical Board",
    "licenseNumberVariations": "MD-12345, 12345",
    "action": "create"
  }
]

Response

Practitioner licenses updated successfully