Info

For new integrations, use the v2 API. See Migrating from v1 to v2 for the mapping between v1 conditions and v2 use cases.

Legacy API (v1) — Conditions

All three conditions — wellness, cognitive, and anemia — follow the same four-endpoint pattern. Replace {condition} in the paths below with wellness, cognitive, or anemia.

Condition-Specific Notes

Condition	Description	Notes
`wellness`	Behavioral health indicators: stress, anxiety, depression, fatigue, sleep	General behavioral health screening
`cognitive`	Cognitive function indicators: cognitive impairment, attention, brain health	Contact support@amplifierhealth.com for integration guidance
`anemia`	Acoustic indicators associated with anemia	Investigational-tier model; use as supplementary context alongside clinical workup

Authentication

All v1 requests use X-Account-ID and X-Secret-Key headers. See Legacy API (v1) for details.

Audio

Supported formats: WAV, FLAC, MP3, M4A. See Audio Requirements. Invalid or unsupported format returns 400 Bad Request.

POST /api/v1/{condition}/analyze-audio

POST/api/v1/{condition}/analyze-audio

Analyze audio file uploaded via multipart form. Replace {condition} with wellness, cognitive, or anemia. Returns a job_id.

Single-speaker recording is recommended. For multi-speaker audio, use POST /api/v1/{condition}/analyze-and-diarize-audio.

Request Body (multipart/form-data)

API Parameters
Field	Type	Required	Description
audio	file	Required	Audio file (WAV, FLAC, MP3, or M4A).

Response

Field	Type	Description
`job_id`	string	Unique identifier for the analysis job. Use with job detail or configure a webhook.

Example

curl -X POST "https://api.amplifierhealth.com/api/v1/wellness/analyze-audio" \
-H "X-Account-ID: your-account-id" \
-H "X-Secret-Key: your-secret-key" \
-F "audio=@recording.wav;type=audio/wav"

Errors

400 when the file does not meet format requirements. 402 when the account has no remaining credits. See Error Reference.

POST /api/v1/{condition}/analyze-audio-url

POST/api/v1/{condition}/analyze-audio-url

Analyze audio from a URL. Replace {condition} with wellness, cognitive, or anemia. Returns a job_id.

Single-speaker recording is recommended. For multi-speaker audio, use POST /api/v1/{condition}/analyze-and-diarize-audio-url.

Request Body (JSON)

API Parameters
Field	Type	Required	Description
url	string	Required	HTTPS URL pointing to an audio file (WAV, FLAC, MP3, or M4A). Must be publicly accessible.

Response

Field	Type	Description
`job_id`	string	Unique identifier for the analysis job.

Example

curl -X POST "https://api.amplifierhealth.com/api/v1/wellness/analyze-audio-url" \
-H "X-Account-ID: your-account-id" \
-H "X-Secret-Key: your-secret-key" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/recording.wav"}'

Errors

400 when the URL is inaccessible or the file does not meet format requirements. 402 when the account has no remaining credits. See Error Reference.

POST /api/v1/{condition}/analyze-and-diarize-audio

POST/api/v1/{condition}/analyze-and-diarize-audio

Analyze audio with automatic speaker diarization. Replace {condition} with wellness, cognitive, or anemia. Returns a job_id.

Diarization identifies individual speakers and analyzes each separately. Use for recordings with two or more speakers — for example, a clinician-patient interview. Diarization adds a flat +50 tokens on top of the base rate.

Request Body (multipart/form-data)

API Parameters
Field	Type	Required	Description
audio	file	Required	Audio file (WAV, FLAC, MP3, or M4A).

Response

Field	Type	Description
`job_id`	string	Unique identifier for the analysis job.

Example

curl -X POST "https://api.amplifierhealth.com/api/v1/wellness/analyze-and-diarize-audio" \
-H "X-Account-ID: your-account-id" \
-H "X-Secret-Key: your-secret-key" \
-F "audio=@recording.wav;type=audio/wav"

Errors

400 for invalid or unsupported format. 402 for no remaining credits. See Error Reference.

POST /api/v1/{condition}/analyze-and-diarize-audio-url

POST/api/v1/{condition}/analyze-and-diarize-audio-url

Analyze audio from a URL with speaker diarization. Replace {condition} with wellness, cognitive, or anemia. Returns a job_id.

Diarization identifies individual speakers and analyzes each separately. Use for recordings with two or more speakers. Diarization adds a flat +50 tokens on top of the base rate.

Request Body (JSON)

API Parameters
Field	Type	Required	Description
url	string	Required	HTTPS URL to an audio file (WAV, FLAC, MP3, or M4A).

Response

Field	Type	Description
`job_id`	string	Unique identifier for the analysis job.

Example

curl -X POST "https://api.amplifierhealth.com/api/v1/wellness/analyze-and-diarize-audio-url" \
-H "X-Account-ID: your-account-id" \
-H "X-Secret-Key: your-secret-key" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/recording.wav"}'

Errors

400 for invalid URL or format. 402 for no remaining credits. See Error Reference.