---
title: "List Trails"
method: GET
path: "/v1/accounts/{account_id}/trails"
tags: ["gateway.openapi_Gateway"]
---

# List Trails

`GET /v1/accounts/{account_id}/trails`

## Path parameters

- `account_id` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string
- `orderBy` string
- `readMask` string

## Response `200`

A successful response.

- GatewayListTrailsResponse
  - `trails` GatewayTrail[]
    - `name` string
    - `displayName` string
    - `createTime` string, date-time
    - `description` string
    - `createdBy` string
    - `langfuseConfig` string — Langfuse configuration for this trail, inherited from the account at creation time. Contains API credentials for a Project within the customer's Langfuse Organization. Serialized JSON format: {"public_key":"pk-lf-xxx","secret_key":"sk-lf-xxx","host":"https://langfuse-prod.fireworks.ai"} If empty, the default Langfuse Organization/Project will be used.
  - `nextPageToken` string — A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `totalSize` integer

## Changes

- **2026-01-30** `920bcfb416a7` — 1 info
  - added the optional property `trails/items/langfuseConfig` to the response with the `200` status
- **2025-12-10** `b5d8d14e7fdc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/trails/get.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) · [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/29a1e4db152c?raw)