List Q&As

Returns a paginated list of the Q&A entries in your organization’s knowledge base — the question/answer pairs your AI agents draw on when replying. Results are ordered by createdAt ascending with a stable tiebreak, so paging through every page is a consistent full export.

GET /v1/knowledge/qa

Authentication

Bearer token in the Authorization header. See Authentication.

Authorization: Bearer rfl_live_...

Query parameters

integer

default:"20"

Number of Q&As per page. Range 1–100.

string

Opaque cursor from the previous response’s nextCursor. See Pagination.

Response

Returns a list envelope containing Qa objects.

The Qa object

string

Unique identifier. Treat it as opaque.

string

Always "qa".

string

The primary phrasing of the question.

string[]

Alternative phrasings of the same question, sorted alphabetically. Empty when only the primary phrasing exists.

string

The answer content.

string | null

ID of the AI agent this Q&A is scoped to, prefixed with agent_. null when the Q&A applies to every agent in the organization.

string

ISO 8601 UTC timestamp of Q&A creation.

string

ISO 8601 UTC timestamp of the most recent update.

Examples

curl "https://api.replyful.com/v1/knowledge/qa?limit=5" \
  -H "Authorization: Bearer rfl_live_..."

const res = await fetch(
  "https://api.replyful.com/v1/knowledge/qa?limit=5",
  { headers: { Authorization: `Bearer ${process.env.REPLYFUL_API_KEY}` } },
);
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.replyful.com/v1/knowledge/qa",
    headers={"Authorization": f"Bearer {os.environ['REPLYFUL_API_KEY']}"},
    params={"limit": 5},
)
res.raise_for_status()
data = res.json()["data"]

Response

{
  "object": "list",
  "data": [
    {
      "id": "V1StGXR8Z5jdHi6BmyT",
      "object": "qa",
      "question": "How do I reset my password?",
      "questionVariations": [
        "Forgot my password",
        "I can't log in"
      ],
      "answer": "Click **Forgot password** on the login page and follow the emailed link.",
      "agentId": "agent_9dKmT3xWq6bYrN8",
      "createdAt": "2026-04-29T14:30:00Z",
      "updatedAt": "2026-04-29T14:32:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJzIjoiMjAyNi0wNC0yOVQxNDozMDowMC4wMDBaIiwiaSI6IlYxU3RHWFI4WjVqZEhpNkJteVQifQ",
  "url": "/v1/knowledge/qa"
}

Walk every page

See the pagination guide for a copy-paste loop in Node and Python.

Error responses

Status	`error.code`	When
`401`	`missing_api_key`	The `Authorization` header is absent.
`401`	`invalid_api_key`	The token is malformed, unknown, or archived.
`422`	`invalid_query_parameter`	A query parameter failed validation. The `param` field names the offender.
`422`	`invalid_cursor`	The `startingAfter` cursor could not be decoded.
`429`	`too_many_requests`	Rate limit exceeded. Honor `Retry-After`.

See Errors for the full error envelope reference.

Documentation

Tickets

Conversations

Knowledge

List Q&As

Authentication

Query parameters

Response

The Qa object

Examples

List Q&As

Walk every page

Error responses

​Authentication

​Query parameters

​Response

​The Qa object

​Examples

​List Q&As

​Walk every page

​Error responses

Authentication

Query parameters

Response

The Qa object

Examples

List Q&As

Walk every page

Error responses