Skip to main content
POST
/
api
/
trace
/
search
Search traces
import requests

url = "https://app.langwatch.ai/api/trace/search"

payload = {
    "query": "<string>",
    "startDate": "2023-11-07T05:31:56Z",
    "endDate": "2023-11-07T05:31:56Z",
    "pageSize": 1000,
    "scrollId": "123",
    "filters": {}
}
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
{
  "traces": [
    {
      "trace_id": "<string>",
      "project_id": "<string>",
      "timestamps": {
        "inserted_at": 123,
        "started_at": 123,
        "updated_at": 123
      },
      "input": {
        "value": "<string>",
        "satisfaction_score": 123
      },
      "output": {
        "value": "<string>"
      },
      "metadata": {
        "sdk_language": "<string>",
        "sdk_version": "<string>"
      },
      "metrics": {
        "tokens_estimated": true,
        "completion_tokens": 123,
        "prompt_tokens": 123,
        "total_cost": 123,
        "total_time_ms": 123,
        "first_token_ms": 123
      },
      "indexing_md5s": [
        "<string>"
      ],
      "error": "<string>",
      "evaluations": [
        {
          "evaluation_id": "<string>",
          "score": 123,
          "timestamps": {
            "finished_at": 123,
            "updated_at": 123
          },
          "evaluator_id": "<string>",
          "name": "<string>",
          "details": "<string>",
          "passed": true,
          "label": "<string>",
          "type": "<string>",
          "status": "<string>"
        }
      ],
      "contexts": [
        "<any>"
      ]
    }
  ],
  "pagination": {
    "scrollId": "123",
    "totalHits": 1254
  }
}

Authorizations

X-Auth-Token
string
header
required

Body

application/json
query
string
startDate
string<date-time>
endDate
string<date-time>
pageSize
integer
Example:

1000

scrollId
string
Example:

"123"

filters
object

Response

200 - application/json

Successful response

traces
object[]
pagination
object
⌘I