Skip to content
Documentation/Sources & citations

List citations

Retrieve previous verification records with pagination and optional thread filtering.

Markdown
GET/api/v1/citationshttps://api.webcite.co

When to use it

Start with page=1&limit=20. The pagination schema allows a maximum of 100, while the controller description still says 50. Use 50 or fewer for compatibility. fields defaults to all; request basic explicitly for a smaller response.

Request

1 credit.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --fail-with-body -X GET 'https://api.webcite.co/api/v1/citations' \
  -H "x-api-key: $WEBCITE_API_KEY"

Path and query parameters

page (query)number

Page number (starts at 1)

Default: 1

minimum: 1
limit (query)number

Results per page (max 50)

Default: 20

minimum: 1maximum: 100
fields (query)string

Predefined field set to return

Values: "minimal""basic""detailed""with_relations""all"

Default: "all"

thread_id (query)string

Filter by thread ID

No request body is required.

Response

Returns data and pagination metadata as defined below. Use the returned pagination values when requesting the next page.

200 response

application/json

dataobject[]required

Array of citation records

Show data fields
api_key_idstring

API key ID used for this citation

citationobject

Citation data (JSON string or array of CitationObject)

created_atstring

Timestamp when the citation was created

idstringrequired

Unique identifier of the citation record

is_activeboolean

Whether the citation is active

promptstringrequired

The original prompt that generated this citation

thread_idstringrequired

Thread ID associated with this citation

updated_atstring

Timestamp when the citation was last updated

user_idstring

User ID who created this citation

messagestringrequired

Response message

paginationobjectrequired

Pagination metadata

Show pagination fields
hasNextPagebooleanrequired

Whether there is a next page

hasPreviousPagebooleanrequired

Whether there is a previous page

limitnumberrequired

Number of items per page

pagenumberrequired

Current page number

totalnumberrequired

Total number of items

totalPagesnumberrequired

Total number of pages

statusCodenumberrequired

HTTP status code

Errors

For 400, check the request fields and source identifiers. For 401, check your API key. For 429, wait for the retry interval. See the errors guide before retrying a billable request.

401
Unauthorized - API key required
Error handling and retry guidance