# Playback Health Notes API

REST APIs for managing clinical notes, transcriptions, and authentication

Version: 1.0.0

## Servers

Production server
```
https://api.public.playbackhealth.com/v1
```

## Security

### BearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Playback Health Notes API](https://apidocs.playbackhealth.com/_bundle/openapi.yaml)

## Other

### Get authentication token

 - [POST /authorize](https://apidocs.playbackhealth.com/openapi/paths/~1authorize/post.md): Authenticate a client using a client ID and secret to obtain an ID token.
This endpoint is used for service-to-service authentication.
The obtained token should be used as a Bearer token in subsequent API calls.

### Get list of notes

 - [GET /notes](https://apidocs.playbackhealth.com/openapi/paths/~1notes/get.md): Retrieve a paginated list of clinical notes.
Supports filtering by date range and email address.
Results are sorted by creation date in descending order.

### Create a new note

 - [POST /notes](https://apidocs.playbackhealth.com/openapi/paths/~1notes/post.md): Create a new clinical note with optional template and language settings.
Returns a pre-signed URL for uploading an audio file.
Creates both note and transcription entries, with transcription content to be populated later.
The providerId is automatically set from the authenticated user's token.

### Get a specific note

 - [GET /notes/{id}](https://apidocs.playbackhealth.com/openapi/paths/~1notes~1%7Bid%7D/get.md): Retrieve a specific clinical note by its ID.
Returns the note's content and metadata.

### Get transcription for a note

 - [GET /notes/{id}/transcription](https://apidocs.playbackhealth.com/openapi/paths/~1notes~1%7Bid%7D~1transcription/get.md): Retrieve the transcription of a clinical note's audio recording.
Returns both raw text and structured transcription data with timestamps.

### Get billing codes for a note

 - [GET /notes/{id}/billingcodes](https://apidocs.playbackhealth.com/openapi/paths/~1notes~1%7Bid%7D~1billingcodes/get.md): Retrieve clinical billing codes (CPT and ICD codes) for a specific note.
Returns both CPT (Current Procedural Terminology) and ICD (International Classification of Diseases) codes.

### Finish a note

 - [POST /notes/{id}/finish](https://apidocs.playbackhealth.com/openapi/paths/~1notes~1%7Bid%7D~1finish/post.md): Marks a note as finished by uploading an empty audio file to S3.
This endpoint validates the note ID format, checks user access to the note,
and uploads an empty audio file to trigger note processing.
The note must belong to the authenticated user's enterprise.

### Get list of transcriptions

 - [GET /transcriptions](https://apidocs.playbackhealth.com/openapi/paths/~1transcriptions/get.md): Retrieve a paginated list of transcriptions.
Supports filtering by date range, status, and language.
Results are sorted by creation date in descending order.