GET/api/v6/tts/synthesis/{id}

Synthesis status

Metadata of a synthesis request by its id.

Scope

API key with the tts service enabled

Usage limit

120 requests per minute

Reads the metadata of a synthesis request by its id, the one returned by POST /api/v6/tts/synthesize. You can only access requests from your own organization.

Path parameters

id

stringrequired

Synthesis identifier returned when synthesizing.

Responses

200

Synthesis metadata.

{
  "success": true,
  "data": {
    "id": "01J9Z4M7K2QABCDEF5GHTV3WXY",
    "status": "completed",
    "cached": false,
    "charCount": 49,
    "durationMs": 3120,
    "language": "es-US",
    "voice": "es-us-female-2",
    "tier": "intermediate",
    "cost": "12.500000",
    "currency": "COP",
    "audioUrl": "https://storage.hablame.co/tts/9f2c...e1.wav?Expires=...&Signature=...",
    "reference": null,
    "errorCode": null,
    "createdAt": "2026-06-23 15:04:05"
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-23T15:06:10+00:00",
    "responseTimeMs": 2.3
  }
}

401

Invalid or missing credentials.

404

No synthesis exists with that id for your organization.

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.401AUTH_SERVICE_NOT_ALLOWEDThe key is not allowed to use the service behind this endpoint.404NOT_FOUNDThe path you requested does not exist in this API.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.

See the full catalog

Scope and limits

Path parameters

Responses

Possible errors