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

# session.tapIntents.list

> Lists the open tap intents this session's tap can confirm; it never returns a code.

```ts theme={null}
list(options?: RequestOptions): Promise<OpenTapIntentsResponse>
```

| | |
| - | - |
| Endpoint | [`GET /v1/units/{unit_id}/tap-intents`](https://docs.endstate.io/api-reference/tap-intents/list-the-tap-intents-this-tap-can-confirm) |
| Credential | Session token (`end_sess_...`) |
| Retry class | `read` |

Retried on network failure, timeout, `429`, and `5xx`.

## Example

```ts theme={null}
const result = await session.tapIntents.list();
```

## Parameters

**unit\_id** `string` *required*

## Returns

`200` - `OpenTapIntentsResponse`.

**tap\_intents** `object[]` *required*

## Errors

Branch on `error.code`, never on the HTTP status - several codes share one.

| Code | HTTP | Retry |
| - | - | - |
| `auth.forbidden` | 403 | Do not retry |
| `auth.unauthorized` | 401 | Do not retry |
| `internal.error` | 500 | Safe to retry |
| `rate_limit.exceeded` | 429 | Safe to retry |
| `session_token.invalid_or_expired` | 401 | Do not retry |
| `session_token.wrong_chip` | 403 | Do not retry |
| `validation.failed` | 400 | Do not retry |

See [Errors and retries](https://docs.endstate.io/sdks/core/errors-and-retries.md) for the error types and how to narrow them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.