---
title: "List Near Earth Asteroid Approaches records"
method: GET
path: "/v1/data/near-earth-asteroid-approaches"
tags: ["Asteroid Approaches"]
---

# List Near Earth Asteroid Approaches records

`GET /v1/data/near-earth-asteroid-approaches`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/near-earth-asteroid-approaches`
- Auth: none declared. Required headers: `X-API-Key`

List Near Earth Asteroid Approaches records with optional filters and pagination.

**Source:** Data courtesy NASA/JPL-Caltech, Center for Near-Earth Object Studies Close-Approach Data API. (Public Domain (U.S. Government Work)).

**Fields returned:**
- `designation` (str) — Object primary designation, e.g. 2024 AB1 or 433 Eros
- `orbit_id` (str) — Identifier of the orbit solution used for the prediction
- `close_approach_time` (str) — Close-approach date and time in universal time, as published by the source
- `julian_date` (float) — Close-approach time as a Julian date, useful for sorting and maths
- `distance_au` (float) — Nominal approach distance in astronomical units
- `distance_min_au` (float) — Minimum approach distance within the uncertainty range, in astronomical units
- `distance_max_au` (float) — Maximum approach distance within the uncertainty range, in astronomical units
- `relative_velocity_km_s` (float) — Velocity relative to Earth at approach, kilometres per second
- `absolute_magnitude` (float) — Absolute magnitude, a proxy for object size — smaller numbers mean larger objects

**Example:** `GET /v1/data/near-earth-asteroid-approaches?limit=10&designation=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `designation` string, nullable: Object primary designation, e.g. 2024 AB1 or 433 Eros
- `close_approach_time` string, nullable: Close-approach date and time in universal time, as published by the source

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Near Earth Asteroid Approaches records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)