DevelopersGet started

Pagination and filtering

Page through AutoRFP.ai API lists with page[number] and page[size], and narrow results with filter[...] parameters, including status lists and dates.

List endpoints return one page of results at a time. You choose the page with the page parameters and narrow the results with filter parameters.

Pagination

Parameter	Description	Default
`page[number]`	The page to return, starting at 1.	`1`
`page[size]`	How many items per page, from 1 to 100.	`25`

The response describes where you are in meta.page and gives ready-made URLs in links:

{
  "data": [],
  "meta": { "page": { "number": 1, "size": 25, "totalItems": 80, "totalPages": 4 } },
  "links": {
    "self": "https://api.autorfp.ai/v1/projects?page[number]=1&page[size]=25",
    "next": "https://api.autorfp.ai/v1/projects?page[number]=2&page[size]=25"
  }
}

The data array is empty and the totals are illustrative. To read a whole list, request pages in turn until you reach meta.page.totalPages.

Filtering

Filters use the filter[...] form. Each list endpoint documents the filters it supports in the reference.

Some filters take several values as a comma-separated list, for example filter[status]=inProgress,completed. The reference says which.
Date filters take an ISO 8601 date-time: filter[createdAfter]=2025-01-01T00:00:00Z.
Combine filters and pagination in one request.

Filter and page

curl -g "https://api.autorfp.ai/v1/projects?filter[status]=inProgress,completed&filter[createdAfter]=2025-01-01T00:00:00Z&page[size]=50" \
-H "Authorization: Bearer $AUTORFP_API_KEY"

import os
import requests

response = requests.get(
"https://api.autorfp.ai/v1/projects",
headers={"Authorization": "Bearer " + os.environ["AUTORFP_API_KEY"]},
params={
"filter[status]": "inProgress,completed",
"filter[createdAfter]": "2025-01-01T00:00:00Z",
"page[size]": 50,
},
)

In curl, pass -g so the square brackets are not treated as a glob pattern.