This chapter contains generally applicable information on API design. When using Ory services, one can expect a consistent experience when interacting with REST APIs.
On REST endpoints that are explicitly labeled as such, pagination information is
available through the
Link HTTP header.
Link header contains a comma-delimited list of links to the following
pages (where applicable):
- Previous (prev)
Pages are created based on the values of
page provided in the
per_page is the page size, and
page is the current page.
In most scenarios, the
per_page should be a multiple of the
Ory's APIs use rfc3339 as the date format: