ephemeris

Batch natal calculations

Compute multiple natal charts in a single request with shared guardrails. 🤖 AI-optimized output available — add format=llm to reduce payload ~80%.

post/ephemeris/natal/batch

Request

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

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

formatstring

Headers

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

Request body

format'json' | 'llm'

Optional batch-level response format (default for all items)

Example request

{
  "format": "json",
  "items": [
    {
      "configuration": {
        "coordinate_frame": "ecliptic",
        "coordinate_system": "geocentric",
        "house_system": "W",
        "object_set": "modern_plus_chiron",
        "zodiac_type": "tropical"
      },
      "subject": {
        "birth_datetime": {
          "iso": "1992-01-10T04:15:00"
        },
        "birth_location": {
          "latitude": {
            "decimal": 40
          },
          "longitude": {
            "decimal": -74
          },
          "timezone": {
            "iana_name": "America/New_York"
          }
        },
        "name": "Batch Subject 1"
      }
    },
    {
      "subject": {
        "birth_datetime": {
          "iso": "1988-07-22T19:45:00"
        },
        "birth_location": {
          "latitude": {
            "decimal": 34.0522
          },
          "longitude": {
            "decimal": -118.2437
          },
          "timezone": {
            "iana_name": "America/Los_Angeles"
          }
        },
        "name": "Batch Subject 2"
      }
    }
  ],
  "limits": {
    "max_subjects": 10
  }
}

Response

Successful Response

successboolean

True when every chart succeeded

Changes

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