> ## Documentation Index
> Fetch the complete documentation index at: https://docs.natural.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When operating Natural directly for a user, use the payments MCP at `https://mcp.natural.com`.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Use REST only for unsupported languages or when the user explicitly requests raw HTTP.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.

# Call log and transcripts

> List voice sessions, read call facts, and fetch a redacted transcript.

Every voice session records the call around the payment: who called, when it started and ended, who hung up, and where the caller went next. The card itself is never part of that record.

<Snippet file="shared/prerequisites.mdx" />

## List sessions

[`GET /voice/sessions`](/api-reference/voice/list-voice-sessions) lists the sessions you created or are collecting for, newest first. Filter by `status`, `createdAfter`, and `createdBefore`. A platform can narrow to one customer with `merchantPartyId`.

```bash cURL theme={null}
curl "https://api.natural.com/voice/sessions?status=completed&limit=20" \
  -H "Authorization: Bearer $NATURAL_API_KEY"
```

<Snippet file="api-examples/voice.list.response.mdx" />

## Read one session

[`GET /voice/sessions/{voiceSessionId}`](/api-reference/voice/get-voice-session) returns the call facts and the `partnerCorrelation` you set when you created it.

```bash cURL theme={null}
curl https://api.natural.com/voice/sessions/vos_019d0a1b2c3d4e5f60718293a4b5c6f0 \
  -H "Authorization: Bearer $NATURAL_API_KEY"
```

<Snippet file="api-examples/voice.get.response.mdx" />

`call.summary` is a short description of the conversation with every run of digits masked. `call.endedBy` says whether Natural's agent or the caller ended the call, and `call.transferredAt` is set when the caller went back to your `returnTarget`.

For the payment, follow the `paymentIntent` relationship and read the [intent](/guides/accept/pay-by-link#follow-the-payment).

## Fetch the transcript

[`GET /voice/sessions/{voiceSessionId}/transcript`](/api-reference/voice/get-voice-session-transcript) fetches the transcript from the voice provider when you ask for it. Natural does not store transcripts, and every run of three or more digits is masked before it reaches you.

```bash cURL theme={null}
curl https://api.natural.com/voice/sessions/vos_019d0a1b2c3d4e5f60718293a4b5c6f0/transcript \
  -H "Authorization: Bearer $NATURAL_API_KEY"
```

<Snippet file="api-examples/voice.transcript.response.mdx" />

When no call reached the provider, the transcript reads `not_available` with no turns.