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

# logs

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
</Tip>

[Source: node-sdk/src/usage.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/usage.ts)

Paginated per-request usage logs, optionally filtered by endpoint.

```ts theme={null}
const page = await client.usage.logs({ endpoint: 'sessions.start', page: 1, page_size: 50 });
page.items.forEach(log => console.log(log.created_at, log.endpoint, log.duration_ms));
```

```typescript theme={null}
NotteUsage.logs(options?: UsageLogsOptions): Promise<PaginatedResponseUsageLog>;
```

## Parameters

<ParamField body="options" type={"UsageLogsOptions"}>
  Default:

  ```typescript theme={null}
  {}
  ```
</ParamField>

## Returns

```typescript theme={null}
Promise<PaginatedResponseUsageLog>
```

## Related types

* [PaginatedResponseUsageLog](/typescript-sdk-reference/types/paginatedresponseusagelog)
* [UsageLogsOptions](/typescript-sdk-reference/types/usagelogsoptions)


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