Get Recent Queries | Fern Documentation

curl -G https://fai.buildwithfern.com/queries/domain \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d page=1 \
     -d limit=10 \
     --data-urlencode cutoff_time=2024-04-01T00:00:00Z \
     -d include_assistant=true \
     --data-urlencode start_date=2024-03-01T00:00:00Z \
     --data-urlencode end_date=2024-03-31T23:59:59Z

{
  "queries": [
    {
      "query_id": "q1234567890abcdef",
      "conversation_id": "conv9876543210fedcba",
      "domain": "example.com",
      "text": "How do I reset my password?",
      "role": "user",
      "source": "web",
      "created_at": "2024-01-15T09:30:00Z",
      "time_to_first_token": 1.1,
      "subqueries": [
        "reset password instructions"
      ],
      "status": "guardrail_blocked"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 10
  }
}

身份验证

AuthorizationBearer

Bearer 身份验证，格式为 Bearer <token>，其中 token 是您的身份验证令牌。

路径参数

domainstring必需

查询参数

pageinteger or null可选

The page number for pagination

limitinteger or null可选

The number of queries per page

cutoff_timedatetime or null可选

Only return queries after this time

include_assistantboolean or null可选

Whether to include assistant responses in the results

start_datedatetime or null可选

The start date of the period to retrieve analytics for

end_datedatetime or null可选

The end date of the period to retrieve analytics for

响应

Successful Response

querieslist of objects

List of queries matching the request criteria

paginationobject

Pagination information

错误

422

Unprocessable Entity Error

$	curl -G https://fai.buildwithfern.com/queries/domain \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d page=1 \
>	-d limit=10 \
>	--data-urlencode cutoff_time=2024-04-01T00:00:00Z \
>	-d include_assistant=true \
>	--data-urlencode start_date=2024-03-01T00:00:00Z \
>	--data-urlencode end_date=2024-03-31T23:59:59Z

1	{
2	"queries": [
3	{
4	"query_id": "q1234567890abcdef",
5	"conversation_id": "conv9876543210fedcba",
6	"domain": "example.com",
7	"text": "How do I reset my password?",
8	"role": "user",
9	"source": "web",
10	"created_at": "2024-01-15T09:30:00Z",
11	"time_to_first_token": 1.1,
12	"subqueries": [
13	"reset password instructions"
14	],
15	"status": "guardrail_blocked"
16	}
17	],
18	"pagination": {
19	"total": 1,
20	"page": 1,
21	"limit": 10
22	}
23	}