List asks for a person and callbacks

GET
/v1/person-requests

The calls that asked for a person (take_call, with each number rung and what happened) and the callbacks callers asked for (follow_up, with the number and when they asked), oldest first. The same items appear in GET /v1/inbox/needs-you.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Query Parameters

kind?string

Only take_call or only follow_up.

Value in"offered""waiting_for_human""held""delivery_failed""take_call""follow_up""question"
limit?integer

At most this many items (1-100).

Range1 <= value <= 100

Response Body

The asks for a person and the callbacks, oldest first

application/json
  1. response
items*array<>
Example Request
curl "https://api.vlayers.ai/v1/person-requests?kind=follow_up&limit=25" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "items": [    {      "kind": "follow_up",      "conversationId": null,      "channel": null,      "lineId": null,      "peer": "+15550123",      "since": "2026-10-20T15:04:05.000Z",      "waitedSeconds": 600,      "assignedTo": null,      "reason": "Wants a quote",      "summary": "Kitchen remodel",      "holdReason": null,      "heldId": null,      "code": null,      "messageId": null,      "requestId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",      "callId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",      "callbackTo": "+15550123",      "preferredTime": "tomorrow after 3",      "legs": null    }  ]}