Back to Docs

Exact Ingress Search

Exact Ingress Search

POST/api/v1/western/progressions/{system}/exact-ingresses

Use exact ingress search to return windowed sign or house ingress hits for a progression system. Results are exact-event rows, not full chart payloads.

This endpoint requires x-api-key. The example below is a complete authenticated request.

How It Works

When ingress_type is both, the search is sign-first by default: sign ingresses are fully searched, while house ingresses are reduced under the shared limit unless you explicitly request ingress_type="house".

Exact ingress windows are capped by system for performance: secondary and converse secondary up to 3 years, tertiary up to 2 years, quotidian and quaternary up to 1 year.

Supported Systems

This exact-ingresses pattern works for all five systems. Replace {system} with secondary, converse-secondary, tertiary, quotidian, or quaternary.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary/exact-ingresses" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "User",
    "datetime": "1984-05-12 08:30",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "AUTO"
    }
  },
  "search": {
    "from": "2026-03-30",
    "to": "2027-03-30"
  }
}'

Real API Response Example

Captured from the live API on April 14, 2026 using the request above.

{
  "meta": {
    "endpoint": "exact_ingresses",
    "version": "v1",
    "system": "secondary",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "generated_at": "2026-04-14T15:55:26Z"
  },
  "window": {
    "from": "2026-03-30",
    "to": "2027-03-30",
    "limit": 100,
    "order": "asc"
  },
  "events": [
    {
      "event_date": "2026-12-28T18:28:07Z",
      "point": "moon",
      "ingress_type": "sign",
      "from_sign": {
        "name": "Aries",
        "index": 0,
        "abbr": "Ari"
      },
      "to_sign": {
        "name": "Taurus",
        "index": 1,
        "abbr": "Tau"
      },
      "target_datetime_utc": "2026-12-28T18:28:07Z",
      "basis": {
        "age_years_decimal": 42.6305,
        "progressed_days_after_birth": 42.6305,
        "natal_datetime_utc": "1984-05-12T07:30:00Z",
        "progressed_datetime_utc": "1984-06-23T22:37:55Z"
      },
      "interpretation_key": "progressed_moon_ingress_taurus"
    }
  ]
}

Related Docs

Progressions overviewExact aspects