Public API 1.0: Introduction

WARNING

All HTTP requests have to be sent with the Content-Type: application/json header. If the header is not present it will result in malformed responses or request rejections.

This describes the resources that make up the official Public API v1. If you have any problems or requests please open an issue.

Current Version

By default, all requests to a relay receive the v1 version of the Public API. We encourage you to explicitly request this version via the API-Version header.

Pagination

Requests that return multiple items will be paginated to 50 items by default. You can specify further pages with the ?offset parameter. For some resources, you can also set a custom page size up to 100 with the ?limit parameter. Note that for technical reasons not all endpoints respect the ?limit parameter.

Public Testing Relay

If you are not running a relay yourself you can use https://api.swipechain.org/api/ to test API calls. Happy developing!