Skip to content
GET /v1/asteroid

A single minor body by number, name or SPK-ID

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/asteroids-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/asteroids-api/v1/asteroid" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/asteroids-api/v1/asteroid", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/asteroids-api/v1/asteroid");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/asteroids-api/v1/asteroid",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "neo": false,
        "pha": false,
        "name": "Ceres",
        "orbit": {
            "eccentricity": 0.0796,
            "period_years": 4.6,
            "inclination_deg": 10.59,
            "semi_major_axis_au": 2.766
        },
        "spkid": 20000001,
        "albedo": 0.09,
        "number": 1,
        "designation": "1 Ceres (A801 AA)",
        "diameter_km": 939.4,
        "orbit_class": "MBA",
        "rotation_hours": 9.0742,
        "abs_magnitude_h": 3.35,
        "orbit_class_name": "Main-belt Asteroid"
    },
    "meta": {
        "timestamp": "2026-05-31T04:30:16.099Z",
        "request_id": "7d1d241d-62e9-410b-9566-feb8b50dce9c"
    },
    "status": "ok",
    "message": "Minor body retrieved",
    "success": true
}