API Documentation

RESTful API with simple authentication

Overview POST /audit GET /balance GET /audits GET /audits/:id DELETE /audits/:id

GET/audits/:auditId

Returns the full results for a single audit, including all check details and per-file scores. The auditId is returned when you run an audit or from the list endpoint.

Headers

Header	Type	Required	Description
X-API-Key	`string`	Required	Your API key (or use `Authorization: Bearer`)

Example

curl https://api.ttsaudit.com/v1/audits/abc123def456   -H "X-API-Key: YOUR_API_KEY"

Response

Returns the same audit object shape as the list endpoint.

{
  "auditId": "5cc15c75434c42c380d929bea6c7dcf2",
  "fileCount": 12,
  "fileNames": ["ch1.mp3", "ch2.mp3", "..."],
  "selectedAnalyses": ["comparison", "quality", "scriptAccuracy"],
  "accuracy": "standard",
  "score": 87.3,
  "summary": "Speaker consistency 94.2% across 12 files. 1 file flagged.",
  "regenCount": 1,
  "tracksToRegenerate": [
    {
      "file": "ch7.mp3",
      "reasons": [{ "check": "quality", "message": "Low SNR" }]
    }
  ],
  "checks": {
    "comparison": { "score": 94.2, "summary": "..." },
    "quality": { "score": 80.5, "summary": "..." }
  },
  "creditsUsed": 36,
  "audioUrls": ["https://...ch1.mp3", "https://...ch2.mp3"],
  "timing": { "decode": 2.5, "checks": 11.9, "total": 15.1 },
  "source": "api",
  "createdAt": "2026-03-09T13:11:37.816676+00:00"
}

Field	Type	Description
summary	string	Human-readable summary of the audit results
checks	object	Full results keyed by check name (comparison, quality, pace, scriptAccuracy)
tracksToRegenerate	array	Files flagged for regeneration with reasons
audioUrls	array	Signed URLs to the uploaded audio files
timing	object	Processing time breakdown (decode, checks, total)
scripts	object?	Reference scripts if provided during the audit

Ready to integrate?

Get your API key