Pagination

Endpoints that return a list or resources will usually return paginated results and include 25 items by default. To access further pages, use the page parameter:

$ curl -u EMAIL_OR_ACCESS_TOKEN "https://api.phrase.com/v2/projects?page=2"

Some endpoints also allow a custom page size by using the per_page parameter:

$ curl -u EMAIL_OR_ACCESS_TOKEN "https://api.phrase.com/v2/projects?page=2&per_page=50"

Unless specified otherwise in the description of the respective endpoint, per_page allows you to specify a page size up to 100 items.

Link-Headers

We provide you with pagination URLs in the Link Header field. Make use of this information to avoid building pagination URLs yourself. The Link-Header is only available on GET requests that return a list of resources. It contains URLs for the first, previous, next, and last pages of results.

Link: <https://api.phrase.com/v2/projects?page=1>; rel="first", <https://api.phrase.com/v2/projects?page=3>; rel="prev", <https://api.phrase.com/v2/projects?page=5>; rel="next", <https://api.phrase.com/v2/projects?page=9>; rel="last"

Possible rel values are:

Value	Description
next	URL of the next page of results
last	URL of the last page of results
first	URL of the first page of results
prev	URL of the previous page of results

Rate Limiting

Information on rate limiting has moved: Rate Limiting

Overview

API Documentation

Link-Headers

Rate Limiting

​Link-Headers

​Rate Limiting

Link-Headers

Rate Limiting