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
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

domainstringRequired

Query parameters

pageinteger or nullOptional

The page number for pagination

limitinteger or nullOptional

The number of queries per page

cutoff_timedatetime or nullOptional

Only return queries after this time

include_assistantboolean or nullOptional

Whether to include assistant responses in the results

start_datedatetime or nullOptional

The start date of the period to retrieve analytics for

end_datedatetime or nullOptional

The end date of the period to retrieve analytics for

Response

Successful Response

querieslist of objects

List of queries matching the request criteria

paginationobject

Pagination information

Errors

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	}