# Traces

## List

`client.telemetry.traces.list(TraceListParamsquery, RequestOptionsoptions?): TraceListResponse`

**get** `/v1/telemetry/traces`

Get OpenTelemetry traces 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:** `TraceListParams`

  - **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)

### Returns

- `TraceListResponse`
  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`

    - **endTimeUnixNano:** `string`

    - **name:** `string`

    - **startTimeUnixNano:** `string`

    - **status:** `Status`

      - **code:** `number`

      - **message:** `string`

    - **traceId:** `string`

  - **links:** `PaginationLinks`

    Links to use for pagination

### Example

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

const client = new ValTown();

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

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