# List asks for a person and callbacks

Source: https://docs.vlayers.ai/reference/conversations/list-person-requests

`GET /v1/person-requests` · scope `workspace:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `kind` | query | "offered" \| "waiting_for_human" \| "held" \| "delivery_failed" \| "take_call" \| "follow_up" \| "question" | no | Only `take_call` or only `follow_up`. Example: `"follow_up"` |
| `limit` | query | integer | no | At most this many items (1-100). Example: `"25"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/person-requests?kind=follow_up&limit=25" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { items } = await voicelayer.conversations.listPersonRequests({
  kind: 'follow_up',
  limit: 25
});
console.log(items);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.conversations.list_person_requests(kind="follow_up", limit=25)
print(result.items)
```

## Response `200`

```json
{
  "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
    }
  ]
}
```
