API Reference
API Reference / Endpoints / Speech

Speech status

/v1/speech/status/:requestId

Read a speech-specific status payload for a prior speech request.

GET/v1/speech/status/:requestId
Auth: API keyBilling: FreeBehavior: SyncScopes: analytics:read
GETSyncNo bodyanalytics:read

When to use it

Use this when your client wants a speech-shaped status response instead of the unified request endpoint.

Behavior on success

Returns a completed payload on the normal success path.

Integration shape

Authorization model
analytics:read
Request format
No request body
Polling pattern
No polling required on the normal success path.

Request

FieldTypeRequiredDescription
requestIdstringYesRequest identifier returned by a prior async response.

Example request

GET /v1/speech/status/:requestId
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/speech/status/req_123', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
  },
});

const payload = await response.json();
console.log(payload);

Example response

Response shapejson
{
  "success": true,
  "data": {
    "request_id": "req_123",
    "status": "completed",
    "result_url": "https://cdn.wubble.ai/audio/output.mp3",
    "credits_used": 1
  }
}

Implementation notes

Processing responses return 202 with age_minutes.
You can also poll GET /v1/requests/:requestId with analytics:read.

Production guidance

Pair this route with idempotency on POST requests and either request polling or webhooks whenever the response is asynchronous.
Was this page helpful?
Previous
Text to dialogNext