The Clinicians API from Nursa — 4 operation(s) for clinicians.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nursa:nursa-clinicians-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Nursa Public API V2 Clinicians API
version: '2'
x-evidence:
harvested: '2026-08-04'
method: derived
source: https://docs.nursa.com/
note: decoded from the published docusaurus-plugin-openapi-docs page chunks; operations verbatim
description: The Nursa Public API lets healthcare facilities and their scheduling/workforce systems post and manage per diem shifts on the Nursa marketplace, review clinician shift requests, schedule clinicians, handle shift reports and cancellations, read clinician credentials, and subscribe to webhooks.
contact:
name: Nursa API Team
url: https://docs.nursa.com/
email: josh.bear@nursa.com
servers:
- url: https://public-api.prod.nursa.com
description: Production (documented at docs.nursa.com Accessing the API; probed 2026-08-04 -> 401)
- url: https://public-api.sandbox.nursa.com
description: Sandbox (the server declared in the published docs bundle; probed 2026-08-04 -> 401)
security:
- public-api: []
tags:
- name: Clinicians
paths:
/api/v2/public/clinicians/{clinicianId}/details:
get:
operationId: CliniciansController_getDetails
summary: Get Clinician Details
description: 'General Information
This endpoint allows you to retrieve clinician information'
tags:
- Clinicians
security:
- public-api: []
parameters:
- name: clinicianId
required: true
in: path
description: Clinician ID
example: I7002epLHLhBCypdPCrn9XP4kTN2
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
clinicianId:
type: string
description: Id of the clinician
example: gpMEmsoXfWVmhXJIvXipPjo0dc43
firstName:
type: string
description: First name of the clinician
example: John
lastName:
type: string
description: Last name of the clinician
example: Doe
contactEmail:
type: string
description: Email of the clinician
example: john@doe.com
contactPhone:
type: string
description: Contact phone of the clinician
example: '+12345678910'
licenseType:
type: Array
description: List of valid license types of the clinician
example:
- RN
- CNA
required:
- clinicianId
- firstName
- lastName
- contactEmail
- contactPhone
- licenseType
title: GetClinicianDetailsResponse
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: array
description: Error description
items:
type: string
example: Property must be a string
error:
type: string
description: The type of error
example: Bad Request
statusCode:
type: integer
description: Status code of the error
example: 400
examples:
Request Validation:
summary: Request Validation Error
value:
message:
- clinicianId must be a string
error: Bad Request
statusCode: 400
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
description: Error description
statusCode:
type: integer
description: Status code of the error
example: 401
'403':
description: Forbidden
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error description
example: Forbidden Resource
error:
type: string
description: The type of error
example: Forbidden
statusCode:
type: integer
description: Status code of the error
example: 403
/api/v2/public/clinicians/{clinicianId}/documents:
get:
operationId: CliniciansController_getDocuments
summary: Get Clinician Documents
description: 'General Information
This endpoint allows facilities to retrieve a list of all documents associated with a specific clinician.
Required Parameters
clinicianId (path parameter): The unique identifier of the clinician
shiftId (query parameter): The shift ID which the clinician requested
Document Categories
The endpoint returns documents organized by the following categories:
LICENSE: Professional licenses (nursing, medical, etc.)
CREDENTIAL: Professional credentials and certifications
BACKGROUND_CHECK: Background check documents and results
SSN: Social Security Number verification documents
CDPH_530: California Department of Public Health 530 forms
Access Control
The implementation logic requires that a clinician has submitted a shift request to a facility that the facility user is connected to. This requirement is in place to prevent the unauthorized sharing of documentation for users who have not interacted with one of your shifts.'
tags:
- Clinicians
security:
- public-api: []
parameters:
- name: clinicianId
required: true
in: path
description: Clinician ID
example: I7002epLHLhBCypdPCrn9XP4kTN2
schema:
type: string
- name: shiftId
required: true
in: query
description: Id of the shift
example: '4603117571'
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
clinicianId:
type: string
description: Id of the clinician
example: gpMEmsoXfWVmhXJIvXipPjo0dc43
documents:
type: array
description: Array containing clinician documents
items:
oneOf:
- title: Verified Licenses
type: object
required:
- category
- type
- documentId
- hasFile
- status
- compact
- state
- expirationDate
- number
- title: Background Checks
type: object
required:
- category
- type
- documentId
- hasFile
- status
- expirationDate
- completedDate
- title: SSN
type: object
required:
- category
- lastFourDigits
- title: Credentials
type: object
required:
- category
- type
- documentId
- hasFile
- status
- title: CDPH-530
type: object
required:
- category
- type
- documentId
- hasFile
- status
required:
- clinicianId
- documents
title: GetClinicianDocumentsResponse
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: array
description: Error description
items:
type: string
example: Property must be a string
error:
type: string
description: The type of error
example: Bad Request
statusCode:
type: integer
description: Status code of the error
example: 400
examples:
Request Validation:
summary: Request Validation Error
value:
message:
- shiftId must be a string
error: Bad Request
statusCode: 400
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
description: Error description
statusCode:
type: integer
description: Status code of the error
example: 401
'403':
description: Forbidden
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error description
example: Forbidden Resource
error:
type: string
description: The type of error
example: Forbidden
statusCode:
type: integer
description: Status code of the error
example: 403
/api/v2/public/clinicians/{clinicianId}/documents/attachment/{attachmentId}:
get:
operationId: CliniciansController_getAttachment
summary: Download Clinician Document attachment
description: 'General Information
This endpoint allows you to download a specific attachment file associated with a clinician''s document.
Required Parameters
clinicianId (path parameter): The unique identifier of the clinician
attachmentId (path parameter): The unique identifier of the specific attachment to download
File Handling
Files are streamed directly to the client for immediate download'
tags:
- Clinicians
security:
- public-api: []
parameters:
- name: clinicianId
required: true
in: path
description: Clinician ID
example: I7002epLHLhBCypdPCrn9XP4kTN2
schema:
type: string
- name: attachmentId
required: true
in: path
description: Id of the attachment
schema:
type: string
responses:
'201':
description: Empty Response
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: array
description: Error description
items:
type: string
example: Property must be a string
error:
type: string
description: The type of error
example: Bad Request
statusCode:
type: integer
description: Status code of the error
example: 400
examples:
Request Validation:
summary: Request Validation Error
value:
message:
- shiftId must be a string
error: Bad Request
statusCode: 400
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
description: Error description
statusCode:
type: integer
description: Status code of the error
example: 401
'403':
description: Forbidden
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error description
example: Forbidden Resource
error:
type: string
description: The type of error
example: Forbidden
statusCode:
type: integer
description: Status code of the error
example: 403
/api/v2/public/clinicians/{clinicianId}/documents/{category}/{documentId}:
get:
operationId: CliniciansController_getDocumentAttachments
summary: Get Clinician Document attachments
description: 'General Information
This endpoint retrieves all file attachments associated with a specific clinician document.
Required Parameters
clinicianId (path parameter): The unique identifier of the clinician
category (path parameter): The document category (LICENSE, CREDENTIAL, BACKGROUND_CHECK, SSN, CDPH_530)
documentId (path parameter): The unique identifier of the specific document
Access Control
The implementation logic requires that a clinician has submitted a shift request to a facility that the facility user is connected to. This requirement is in place to prevent the unauthorized sharing of documentation for users who have not interacted with one of your shifts'
tags:
- Clinicians
security:
- public-api: []
parameters:
- name: clinicianId
required: true
in: path
description: Clinician ID
example: I7002epLHLhBCypdPCrn9XP4kTN2
schema:
type: string
- name: category
required: true
in: path
description: Category of the document
example: license
schema:
enum:
- background-check
- credential
- license
- ssn
- cdph-530
type: string
- name: documentId
required: true
in: path
description: Id of the document
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
attachmentId:
type: string
description: Id of the attachment
example: '123'
attachmentUrl:
type: string
description: Url of the attachment
example: https://example.com/attachment1.pdf
required:
- attachmentId
- attachmentUrl
title: GetClinicianDocumentAttachmentsResponse
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
message:
type: array
description: Error description
items:
type: string
example: Property must be a string
error:
type: string
description: The type of error
example: Bad Request
statusCode:
type: integer
description: Status code of the error
example: 400
examples:
Request Validation:
summary: Request Validation Error
value:
message:
- shiftId must be a string
error: Bad Request
statusCode: 400
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
description: Error description
statusCode:
type: integer
description: Status code of the error
example: 401
'403':
description: Forbidden
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error description
example: Forbidden Resource
error:
type: string
description: The type of error
example: Forbidden
statusCode:
type: integer
description: Status code of the error
example: 403
components:
securitySchemes:
public-api:
type: http
scheme: bearer
bearerFormat: JWT
description: Please, fill this with your authorization token
externalDocs:
description: Nursa Public API documentation
url: https://docs.nursa.com/