API Reference

Base URL

All API requests should be made to:

https://api.sealegs.ai/v3

Request Format

All requests must include:

• Authorization header: Authorization: Bearer YOUR_API_KEY
• Content-Type header: Content-Type: application/json (for POST/PUT requests)

curl -X POST https://api.sealegs.ai/v3/spotcast \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"coordinates": {"latitude": 25.76, "longitude": -80.19}, ...}'

Response Format

All responses are returned as JSON. Successful responses have a 2xx status code.

Success Response

{
  "id": "spc_abc123xyz",
  "status": "completed",
  "created_at": "2025-12-01T10:30:00Z",
  ...
}

Error Response

{
  "error": {
    "code": "invalid_coordinates",
    "message": "Latitude must be between -90 and 90",
    "param": "coordinates.latitude"
  }
}

Endpoints Overview

SpotCast Endpoints

Account Endpoints

Common Parameters

Coordinates

Pagination

List endpoints support cursor-based pagination:

Paginated responses include:

{
  "data": [...],
  "has_more": true,
  "next_cursor": "spc_xyz789"
}

Rate Limiting

All responses include rate limit headers:

See Rate Limits for more details.

HTTP Status Codes

Next Steps