Introduction

The Mailyard API is REST over HTTPS with JSON responses. Authenticate with a secret key in the Authorization header. All requests go to https://api.mailyard.com/v1.

200 / 201: It worked.
422: A parameter is missing or wrong. The errors say which.
401: The key is missing or revoked.
429: Too many requests. Slow down and retry.

curl https://api.mailyard.com/v1/inboxes \
  -H "Authorization: Bearer $MAILYARD_KEY"

Response200 OK

{
  "data": [ … ],
  "links": { "next": null, … },
  "meta": { "current_page": 1, "per_page": 25, "total": 3 }
}