New: AI video tools. Cut, clip, caption and dub your videos. See all video tools →
Account

List requests

GET
/v1/requests

Lists your API requests, newest first. Pass next_before as before to get the next page, until it is null. A page can be empty while next_before is set, or hold more than limit requests made at the same moment.

Authorization

bearer
headerAuthorizationBearer <API key>

An API key from Settings, starting vcp_live_.

Query Parameters

limit?integer

Requests per page.

Range1 <= value <= 100
Default50
before?string

Only requests made before this time.

Formatdate-time
type?string
Value in"speech""voice_design""voice_clone""voice_change""transcription""dub""avatar_video""cut"
status?string
Value in"queued""running""succeeded""failed""cancelled"
key_id?string

Only requests made with this API key.

Formatuuid

Response Body

OK.

application/json
  1. response
requests*array<>
next_before*|

Pass as before to get the next page, or null on the last page.

Formatdate-time
Example Request
curl -X GET 'https://api.vcp.name/v1/requests'
Example Response
{  "requests": [    {      "id": "04bd0571-e2c8-4d5b-a3cc-e56f85773abf",      "type": "speech",      "status": "succeeded",      "error": null,      "tokens_charged": 42,      "api_key_id": "5f0c2a8e-3b1d-4c7e-9a62-1d8f4e7b2c90",      "summary": {        "text": "Hello from the API.",        "voice": "Alloy",        "model": "kokoro"      },      "created_at": "2026-10-30T00:10:42Z",      "finished_at": "2026-10-30T00:18:01Z"    }  ],  "next_before": null}