Skip to main content

REST API parameters

API parameters can be used with the REST API to filter, sort, and paginate results and to select fields and relations to populate. Additionally, specific parameters related to optional Strapi features can be used, like the publication state and locale of a content-type.

The following API parameters are available:

OperatorTypeDescription
sortString or ArraySort the response
filtersObjectFilter the response
populateString or ObjectPopulate relations, components, or dynamic zones
fieldsArraySelect only specific fields to display
paginationObjectPage through entries
publicationStateStringSelect the Draft & Publish state

Only accepts the following values:
  • live(default)
  • preview
localeString or ArraySelect one or multiple locales

Query parameters use the LHS bracket syntax (i.e. they are encoded using square brackets [])

💡 Tip

A wide range of REST API parameters can be used and combined to query your content, which can result in long and complex query URLs.
👉 You can use Strapi's interactive query builder tool to build query URLs more conveniently. 🤗