Professional Licenses

The professional license resource represents a single certification or license issued to a candidate for qualification in a professional field. Candidates may have two existing professional license resources at a time.

Operations

Create a new Professional License

Request

Creates a new Professional License for a given candidate. A maximum of two licenses may exist for each candidate. When a report is run with Professional License Verification, all candidate licenses existing at the time of report creation will be included for verification.

Security

basic_auth

Path

candidate_idstringrequired

The Candidate's ID

Bodyapplication/json

expiration_datestring, (date)

Expiration date of the professional license

Example:"2033-01-30"

issuer_namestringrequired

Name of the organization that issued the professional license

Example:"Medical Board of California"

issuer_regionstringrequired

2-letter abbreviation of US state where license was issued. For licenses not issued for a specific state, use "United States".

Example:"CA"

license_typestringrequired

Category or industry of professional license

Example:"Physician"

license_numberstring

Unique identifier assigned to license by issuer. Format may vary

Example:"A 12345"

certification_document_idstringrequired

ID of document previously created with the uploadDocument endpoint. Document must be of type professional_license_certification_image and should contain an image proof of professional license to be verified.

curl -i -X POST \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/candidates/{candidate_id}/professional_licenses' \
  -H 'Content-Type: application/json' \
  -d '{
    "expiration_date": "2033-01-30",
    "issuer_name": "Medical Board of California",
    "issuer_region": "CA",
    "license_type": "Physician",
    "license_number": "A 12345",
    "certification_document_id": "string"
  }'

Responses

Professional License was successfully created

Bodyapplication/json

idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"