Overview

The SeRSSly REST API uses JSON for request and response bodies. All endpoints require authentication unless noted otherwise.

Base URL

https://serssly.com/api/v1

Authentication

Include your API key as a Bearer token in every request:

Authorization: Token your-api-key-here

Pagination

List endpoints use keyset pagination. Responses include a pagination object with next_url and previous_url cursors. Follow next_url to fetch the next page.

{
  "email_addresses": [...],
  "pagination": {
    "limit": 20,
    "next_url": "/api/v1/email_addresses?cursor=eyJpZCI6MjB9",
    "previous_url": null
  }
}

Error responses

Errors return appropriate HTTP status codes with a JSON body:

Endpoints