predictive

Calculate progressed chart (Secondary, Tertiary, Solar Arc)

Return progressed positions, aspects, and metadata for a subject. Supports Secondary (Naibod), Tertiary, and Solar Arc methods. 🤖 AI-optimized output available — add ormat=llm to reduce payload ~70%.

post/ephemeris/progressed

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/progressed
  • 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

Query parameters

output_modestring nullable

Deprecated: use preset+format. Accepts full|simple|llm.

formatstring

Response format: json | llm.

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

include_visualboolean

If true, also render a bi-wheel (natal inner ring, progressed or directed outer ring) as SVG or PNG. Visuals incur a +2 credit surcharge.

Example request

{
  "configuration": {
    "house_system": "P",
    "object_set": "asteroids_major",
    "zodiac_type": "tropical"
  },
  "options": {
    "include_aspects": true,
    "include_declination_aspects": true
  },
  "progression_options": {
    "day_year_ratio": 1,
    "method": "secondary"
  },
  "subject": {
    "birth_datetime": {
      "iso": "1990-01-01T12:00:00Z"
    },
    "birth_location": {
      "latitude": {
        "decimal": 34.0522
      },
      "longitude": {
        "decimal": -118.2437
      },
      "timezone": {
        "iana_name": "America/Los_Angeles"
      }
    },
    "name": "Secondary Progression Example"
  },
  "target_datetime": {
    "iso": "2025-11-06T00:00:00Z"
  }
}

Response

Successful progressed chart calculation

output_modestring

Output projection mode (full | simple | llm)

schema_versionstring

Schema version for the selected output mode (e.g., full_v1, simple_v1, llm)

successboolean

Indicates progression succeeded

Example response

{
  "metadata": {
    "calculation_metadata": {
      "technique_id": "natal",
      "technique_label": "Composite (Davison)",
      "technique_method": "davidson",
      "technique_version": "v1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.