Scaleogic Public API

Use the public API to read your Scaleogic collection from external dashboards, automations, or reporting tools.

Authentication

Generate an API key from Account API Keys, then send it with every request:

Authorization: Bearer <your_api_key>

Keys are shown once at creation. Scaleogic stores only a SHA-256 hash and the display prefix.

Returns paginated snakes for the API key owner. Query params: status, species, page, limit.

curl "https://www.scaleogic.com/api/v1/snakes?status=Active&species=Ball%20Python&page=1&limit=50" \
  -H "Authorization: Bearer <your_api_key>"

{
  "data": [/* Snake[] */],
  "total": 42
}

Returns one snake by numeric ID. The snake must belong to the API key owner.

curl "https://www.scaleogic.com/api/v1/snakes/123" \
  -H "Authorization: Bearer <your_api_key>"

{
  "data": { /* Snake */ }
}

Returns collection summary counts by species, status, and sex.

curl "https://www.scaleogic.com/api/v1/stats" \
  -H "Authorization: Bearer <your_api_key>"

{
  "total": 42,
  "by_species": { "Ball Python": 28 },
  "by_status": { "Active": 30 },
  "by_sex": { "Female": 20 }
}