---
title: "Check aspects between two longitudes"
method: POST
path: "/ephemeris/aspect-check"
tags: ["ephemeris"]
---

# Check aspects between two longitudes

`POST /ephemeris/aspect-check`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/ephemeris/aspect-check`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Lightweight endpoint for calculating aspects between two celestial longitudes. Supports filtering by aspect type and custom orb limits.

## Query parameters

- `output_mode` string, nullable
- `format` string

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable
- `X-OpenEphemeris-API-Key` string, nullable
- `apikey` string, nullable

## Request body

- AspectCheckRequest: Request for aspect calculation between two points.
  - `aspect_types` string[]: Filter aspects by type (omit for all types). Valid: conjunction, opposition, trine, square, sextile, quintile, semi_sextile, quincunx, semi_square, sesquiquadrate
  - `longitude1` number, required: First point ecliptic longitude in degrees (0-360)
  - `longitude2` number, required: Second point ecliptic longitude in degrees (0-360)
  - `max_orb` number: Maximum orb allowance in degrees (default: 6.0)

## Response `200`

Aspects calculated successfully

- AspectCheckResponse: The angular relationship between two celestial points, including the closest aspect and all aspects formed within the specified orb.
  - `angular_separation` number, required: Angular separation between points in degrees (0-180)
  - `aspects` AspectResponse[]: All aspects found within orb tolerance
    - `angle` number, required: Aspect angle in degrees
    - `applying` boolean, required: Is aspect applying
    - `aspect` string, required: Aspect name
    - `object1` string, required: First object name
    - `object2` string, required: Second object name
    - `orb` number, required: Orb in degrees
  - `closest_aspect` AspectResponse: Individual aspect information (legacy format).
    - `angle` number, required: Aspect angle in degrees
    - `applying` boolean, required: Is aspect applying
    - `aspect` string, required: Aspect name
    - `object1` string, required: First object name
    - `object2` string, required: Second object name
    - `orb` number, required: Orb in degrees
  - `success` boolean: Calculation success status

## Other responses

- `400`: Invalid input (e.g., longitude out of range)
- `422`: Validation Error
- `500`: Calculation error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)