## List

`client.telemetry.logs.list(LogListParamsquery, RequestOptionsoptions?): LogListResponse`

**get** `/v1/telemetry/logs`

Get OpenTelemetry logs within a specified time window with flexible pagination options: Pass in only the end time to paginate backwards from there. Pass in a start time to paginate backwards from now until the start time. Pass in both to get resources within the time window. Filter additionally by branch_ids or file_id.

### Parameters

- **query:** `LogListParams`

  - **limit:** `number`

    Maximum items to return in each paginated response

  - **branch\_ids:** `Array<string>`

    Branch IDs to filter by

  - **end:** `string`

    End date of the time window (latest time)

  - **file\_id:** `string`

    Include only resources from a given file identified by its ID

  - **start:** `string`

    Start date of the time window (earliest time)

  - **trace\_ids:** `Array<string>`

### Returns

- `LogListResponse`
  A paginated result set

  - **data:** `Array<Data>`

    - **attributes:** `Array<Attribute>`

      - **key:** `string`

      - **value:** `Value`

        - **arrayValue:** `unknown`

        - **boolValue:** `boolean`

        - **bytesValue:** `string`

        - **doubleValue:** `number`

        - **intValue:** `string`

        - **kvlistValue:** `unknown`

        - **stringValue:** `string`

    - **body:** `Body`

      - **arrayValue:** `unknown`

      - **boolValue:** `boolean`

      - **bytesValue:** `string`

      - **doubleValue:** `number`

      - **intValue:** `string`

      - **kvlistValue:** `unknown`

      - **stringValue:** `string`

    - **severityText:** `string`

    - **timeUnixNano:** `string`

    - **traceId:** `string`

  - **links:** `PaginationLinks`

    Links to use for pagination

### Example

```node
import ValTown from '@valtown/sdk';

const client = new ValTown();

const logs = await client.telemetry.logs.list({ limit: 1 });

console.log(logs.data);
```