Skip to main content
GET
List satellite altimeter passes

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token in the Authorization header.

Format: Authorization: Bearer YOUR_API_KEY

Alternative: Pass as query parameter ?api_key=YOUR_API_KEY

Security: API keys are stored as BCrypt hashes (never plain text). Only the hash is stored in the database.

Query Parameters

mission
string

Filter passes to a single satellite mission, by slug (see GET /buoys/satellites).

active_only
boolean
default:true

When true (default), return only passes that have fresh, displayable buoy readings.

since
string<date-time>

Only return passes at or after this ISO 8601 timestamp.

limit
integer
default:20

Maximum number of passes to return (default: 20, max: 100).

Required range: 1 <= x <= 100

Response

Successful response

status
string
Example:

"success"

data
object