Pagination and Filtering

​

Pagination

When endpoints return large datasets, such as collections, pagination helps manage the response. Use the page and take query parameters to control pagination:

• page: Specifies the page number to retrieve. Default is 1.
• take: Specifies the number of records per page. Default is 100.

To retrieve the first 50 collections in an organization, use the following query parameters:

curl --request GET \
 --url 'https://api.withcortex.ai/apps/{app_id}/collections?page=1&take=50'

​

Filtering

Endpoints may support filtering to refine responses. Filtering parameters vary by endpoint. For example, the /collections endpoint supports the following filters:

• search: Search for a specific term within the response.
• visibility: Filter collections by visibility status.
• tags: Filter collections by associated tags.

To search for collections with the term “Debt,” visibility “PUBLIC,” and tags “pending,” use these query parameters:

curl --request GET \
 --url 'https://api.withcortex.ai/apps/{app_id}/collections?search=Debt&visibility=PUBLIC&tags=pending'