Skip to content

CertifyOS API

Download OpenAPI description
Overview
Languages
Servers
Mock server
https://docs.certifyos.com/_mock/reference/application/api/
Production
https://ng-api-production.certifyos.com/
Staging (Test Data)
https://ng-api-stg.certifyos.com/

auth-tokens

Operations

credentialing-workflows

Operations

v2/credentialing-workflows

Operations

providers

Operations

v2/provider

Operations

Retrieve groups/ org-entities for a provider.

Request

Fetches all the groups (org-entities) associated with a provider.

Security
BearerAuth
Path
providerIdstringrequired
Headers
organization-idstring
curl -i -X GET \
  'https://docs.certifyos.com/_mock/reference/application/api/v2/provider/{providerId}/groups' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'organization-id: string'

Responses

Provider Groups.

Bodyapplication/jsonArray [
group_namestringrequired

Name of the group

group_npistring= 10 charactersrequired

Group National Provider Identifier (NPI)

Example: "2345678901"
group_tinstring= 9 charactersrequired

Group Tax Identification Number (TIN)

Example: "123456789"
external_group_idstring

Client's ID for the group

idstringrequired
]
Response
application/json
[ { "group_name": "string", "group_npi": "2345678901", "group_tin": "123456789", "external_group_id": "string", "id": "string" } ]

Retrieve credentialing workflow timelines for a provider

Request

Returns a list of credentialing workflow timeline records for the specified provider within the organization. Each record contains credentialing status, cycle, dates, and related metadata.

Security
BearerAuth
Path
providerIdstringrequired

The unique identifier of the provider whose credentialing workflow timelines are being retrieved.

Headers
organization-idstring
curl -i -X GET \
  'https://docs.certifyos.com/_mock/reference/application/api/v2/provider/{providerId}/credentialing-workflow-timelines' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'organization-id: string'

Responses

Credentialing workflow timelines

Bodyapplication/jsonArray [
credentialingWorkflowIdstringrequired
credentialingStatusstringrequired
credentialingCyclestringrequired
providerIdstringrequired
organizationIdstringrequired
orgEntityobject(CredentialingWorkflowOrgEntityTypeDto)required
idstringrequired
Default null
namestring
Default null
medicalDirectorIdstringrequired
medicalDirectorNamestringrequired
receivedForCredentialingDatestringrequired
attestationDatestringrequired
initialCredentialingDatestringrequired
lastCredentialedDatestringrequired
psvCompleteDatestringrequired
credentialingDecisionDatestringrequired
nextCredentialingDatestringrequired
updatedAtstringrequired
updatedByNamestringrequired
updatedBystringrequired
createdAtstringrequired
createdBystringrequired
createdByNamestringrequired
decisionEnteredByIdstringrequired
decisionEnteredByNamestringrequired
]
Response
application/json
[ { "credentialingWorkflowId": "string", "credentialingStatus": "string", "credentialingCycle": "string", "providerId": "string", "organizationId": "string", "orgEntity": { … }, "medicalDirectorId": "string", "medicalDirectorName": "string", "receivedForCredentialingDate": "string", "attestationDate": "string", "initialCredentialingDate": "string", "lastCredentialedDate": "string", "psvCompleteDate": "string", "credentialingDecisionDate": "string", "nextCredentialingDate": "string", "updatedAt": "string", "updatedByName": "string", "updatedBy": "string", "createdAt": "string", "createdBy": "string", "createdByName": "string", "decisionEnteredById": "string", "decisionEnteredByName": "string" } ]

Create Bulk Provider Professional IDs

Request

Create multiple professional IDs for a provider

Security
BearerAuth
Path
providerIdstringrequired
Headers
organization-idstring
Bodyapplication/jsonrequired
professional_idsArray of objects(CreateProfessionalIdV2Dto)required

Array of professional IDs to create

typestringrequired

Type of professional ID

Enum"Medicare Number""Medicaid Number""ECFMG Number""Foreign National Identification Number""Unique Physician Identification Number""CLIA""DEA"
numberstringrequired

Professional ID number

issue_datestring(date-time)

Issue date of the professional ID

expiration_datestring(date-time)

Expiration date of the professional ID

notesstring

Notes about the professional ID

statestring

State associated with the professional ID

Enum"AK""AL""AR""AS""AZ""CA""CO""CT""DC""DE"
sourcestring

Source of the professional ID

curl -i -X POST \
  'https://docs.certifyos.com/_mock/reference/application/api/v2/provider/{providerId}/professional-ids' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'organization-id: string' \
  -d '{
    "professional_ids": [
      {
        "type": "Medicare Number",
        "number": "string",
        "issue_date": "2019-08-24T14:15:22Z",
        "expiration_date": "2019-08-24T14:15:22Z",
        "notes": "string",
        "state": "AK",
        "source": "string"
      }
    ]
  }'

Responses

Professional IDs created successfully.

Bodyapplication/jsonArray [
idstringrequired

Unique identifier for the professional ID

typestringrequired

Type of professional ID

Enum"Medicare Number""Medicaid Number""ECFMG Number""Foreign National Identification Number""Unique Physician Identification Number""CLIA""DEA"
numberstringrequired

Professional ID number

issue_datestring

Issue date of the professional ID

expiration_datestring

Expiration date of the professional ID

notesstring

Notes about the professional ID

statestring

State associated with the professional ID

sourcestring

Source of the professional ID

]
Response
application/json
[ { "id": "string", "type": "Medicare Number", "number": "string", "issue_date": "string", "expiration_date": "string", "notes": "string", "state": "string", "source": "string" } ]

v2/providers

Operations

v2/flags

Operations

v2/provider-with-groups

Operations

flags

Operations

v2/groups

Operations

Webhooks

Operations

forms

Operations

v2/facility-credentialing-workflows

Operations

v2/facilities

Operations