Skip to main content

Base URL

All API endpoints are available under:
https://spacex.atlas.arenaphysica.com/api/v1/

Authentication

Every request requires a Bearer token in the Authorization header:
curl https://spacex.atlas.arenaphysica.com/api/v1/systems \
  -H "Authorization: Bearer <your-token>"
Requests without a valid token return 401 Unauthorized. See Authentication for how to obtain a token.

Pagination

List endpoints support limit and offset query parameters:
ParameterDefaultDescription
limit50Number of results to return
offset0Number of results to skip
curl "https://spacex.atlas.arenaphysica.com/api/v1/issues?limit=20&offset=40" \
  -H "Authorization: Bearer <your-token>"

Errors

All errors return a JSON response body with a detail field:
{
  "detail": "Not found."
}
Status codeMeaning
400Bad request: check request body or parameters
401Unauthorized: missing or invalid token
403Forbidden: insufficient permissions
404Not found
422Unprocessable entity: validation error
500Server error

Soft deletes

Most delete endpoints soft-delete resources. They are excluded from list responses but remain in the database. Some resources have a corresponding restore endpoint.

Content type

For all POST, PUT, and PATCH requests with a request body, set:
Content-Type: application/json
File uploads use multipart/form-data.