Lists

A list is a plain JSON array. The API has no pagination.

Terminal

curl -H "Authorization: Bearer $FERRY_TOKEN" http://127.0.0.1:7878/api/v1/services

The answer is one JSON array with all the items. The API has no pagination.

Lists of deploys and of job runs

These two lists have the newest item first. They accept ?limit=.

Parameter	Default	Range
`limit`	20	1 to 500

List	Endpoint
The deploys of a service	`GET /api/v1/services/{id}/deploys`
The job runs of a service	`GET /api/v1/services/{id}/jobs`

See Deploys and Jobs in the API reference.

Responses

An answer is JSON with snake_case fields. The status tells what the server did.

Errors

Each error has the same JSON body, with a stable code and a message for people.