--- title: "Measure observed electional rule tolerance in time and venue directions" method: POST path: "/api/astro/electional-tolerance-frontier" tags: ["Calculations"] --- # Measure observed electional rule tolerance in time and venue directions `POST /api/astro/electional-tolerance-frontier` ## Request - Base URL: `https://api.cosmicephemeris.com` - URL: `https://api.cosmicephemeris.com/api/astro/electional-tolerance-frontier` - Auth: one of: - HTTP bearer - API key in header `x-api-key` Resolves one exact civil event instant, then walks outward through ten bounded samples in each earlier/later schedule direction and along each of eight venue bearings. Every selected electional criterion reports the last observed match, first observed failure, first unavailable sample, and traceable sample IDs. This is directional sampled evidence, not an exact boundary, continuous-time proof, monotonicity claim, whole-disk guarantee, recommendation, ranking, interpretation, prediction, or statistical confidence. One standard quota unit per admitted request; failed or timed-out admitted attempts are not refunded. Do not automatically retry. Historical mode uses an explicit BCE/CE date object and UT1 conventions. Its response is the versioned historical envelope, not the modern UTC envelope. Read result for calculation fields and metadata for limits and uncertainty. ## Headers - `X-Cosmic-Ephemeris-Receipt` 'v1' ## Request body - union - ElectionalToleranceFrontierRequest - `event` HouseSystemReadinessBirth, required - `date` string, date, required: Valid Gregorian YYYY-MM-DD local civil date, inclusive 1800-01-01 through 2200-12-31. Calendar validity and timezone conversion are checked by the server. - `time` string, required: HH:MM or HH:MM:SS; no offset in this field. Use timezone to select the civil-time zone. - `timezone` string, required - `lat` number, required - `lon` number, required - `profile` union, required - object - `zodiac` 'tropical', required - object - `zodiac` 'sidereal', required - `ayanamsa` 'lahiri' | 'raman' | 'krishnamurti' | 'fagan_bradley' | 'yukteshwar' | 'sassanian' | 'true_chitra' | 'true_revati' | 'true_pushya' | 'galactic_center_0_sagittarius' | 'galactic_alignment_mardyks', required - `filters` ElectionalFilters, required - `moon_signs` ElectionalSignName[] - `moon_phase_sectors` MoonPhaseSector[] - `mercury_motion` 'direct' | 'retrograde' - `ascendant_signs` ElectionalSignName[] - `aspects` ElectionalAspectFilter[] - `body_a` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `body_b` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `aspect` 'conjunction' | 'sextile' | 'square' | 'trine' | 'opposition', required - `max_orb_degrees` number, required - `max_time_shift_minutes` integer, required - `max_location_radius_km` number, required - HistoricalElectionalToleranceFrontierRequest: Explicit historical mode, 1000 BCE (BC)–2500 CE (AD). No year zero, implicit calendar, UTC or IANA zone. Preserve tool-specific mathematical, geographic and search limits; calendar/time conventions and estimated Delta-T are not certified historical accuracy. - `event` HistoricalBirthInput, required - `date` HistoricalDate, required: Explicit civil date, 1000 BCE (BC)–2500 CE (AD); no year zero. Calendar validity is checked by the server. Available only on documented connected historical operations, with explicit UT1/fixed-offset conventions. - `year` integer, required - `era` 'BCE' | 'CE', required: Display BCE (BC) / CE (AD); API values remain BCE / CE. No year zero. - `month` integer, required - `day` integer, required - `calendar` 'proleptic_gregorian' | 'proleptic_julian', required: Explicit choice; applies the selected calendar rules throughout history without a regional adoption switch. - `time` string, required: Explicit HH:MM[:SS]; whole seconds only, no leap seconds. Normalized helper output includes seconds. - `timezone` string, required: Explicit UT1 or fixed offset UT1+/-HH:MM[:SS], within 14 hours. Local clock minus offset yields UT1, not UTC. No IANA timezone inference. Original offset spelling is preserved. - `lat` number, required - `lon` number, required - `profile` union, required - object - `zodiac` 'tropical', required - object - `zodiac` 'sidereal', required - `ayanamsa` 'lahiri' | 'raman' | 'krishnamurti' | 'fagan_bradley' | 'yukteshwar' | 'sassanian' | 'true_chitra' | 'true_revati' | 'true_pushya' | 'galactic_center_0_sagittarius' | 'galactic_alignment_mardyks', required - `filters` object, required - `moon_signs` string[] - `moon_phase_sectors` string[] - `mercury_motion` 'direct' | 'retrograde' - `ascendant_signs` string[] - `aspects` object[] - `body_a` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `body_b` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `aspect` 'conjunction' | 'sextile' | 'square' | 'trine' | 'opposition', required - `max_orb_degrees` number, required - `max_time_shift_minutes` integer, required - `max_location_radius_km` number, required ## Response `200` Bounded directional electional tolerance evidence - union - ElectionalToleranceFrontierResponse - `type` 'electional_tolerance_frontier', required - `status` 'current', required - `input` object, required - `event` HouseSystemReadinessBirth, required - `date` string, date, required: Valid Gregorian YYYY-MM-DD local civil date, inclusive 1800-01-01 through 2200-12-31. Calendar validity and timezone conversion are checked by the server. - `time` string, required: HH:MM or HH:MM:SS; no offset in this field. Use timezone to select the civil-time zone. - `timezone` string, required - `lat` number, required - `lon` number, required - `profile` union, required - object - `zodiac` 'tropical', required - object - `zodiac` 'sidereal', required - `ayanamsa` 'lahiri' | 'raman' | 'krishnamurti' | 'fagan_bradley' | 'yukteshwar' | 'sassanian' | 'true_chitra' | 'true_revati' | 'true_pushya' | 'galactic_center_0_sagittarius' | 'galactic_alignment_mardyks', required - `filters` ElectionalFilters, required - `moon_signs` ElectionalSignName[] - `moon_phase_sectors` MoonPhaseSector[] - `mercury_motion` 'direct' | 'retrograde' - `ascendant_signs` ElectionalSignName[] - `aspects` ElectionalAspectFilter[] - `body_a` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `body_b` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `aspect` 'conjunction' | 'sextile' | 'square' | 'trine' | 'opposition', required - `max_orb_degrees` number, required - `max_time_shift_minutes` integer, required - `max_location_radius_km` number, required - `center` ElectionalToleranceFrontierSample, required - `id` string, required - `time_sample_id` string, required - `time_offset_seconds` integer, required - `at_utc` string, date-time, required: Normalized UTC timestamp; fractional seconds may be present. - `location_sample_id` string, required - `bearing_degrees` number, nullable, required - `distance_km` number, required - `lat` number, required - `lon` number, required - `status` 'available' | 'unavailable', required - `reason_code` 'undefined_for_input_geometry', nullable, required - `matches_all` boolean, nullable, required - `criteria` ElectionalRobustnessAuditEvaluation[], nullable, required - `id` string, required - `kind` 'moon_signs' | 'moon_phase_sectors' | 'mercury_motion' | 'ascendant_signs' | 'aspect', required - `matched` boolean, required - `observed` union, required - 'Aries' | 'Taurus' | 'Gemini' | 'Cancer' | 'Leo' | 'Virgo' | 'Libra' | 'Scorpio' | 'Sagittarius' | 'Capricorn' | 'Aquarius' | 'Pisces' - 'new_moon' | 'waxing_crescent' | 'first_quarter' | 'waxing_gibbous' | 'full_moon' | 'waning_gibbous' | 'last_quarter' | 'waning_crescent' - 'direct' | 'retrograde' | 'stationary' - number - `time_samples` ElectionalToleranceFrontierTimeSample[], required - `id` string, required - `offset_seconds` union, required - integer - integer - `at_utc` string, date-time, required: Normalized UTC timestamp; fractional seconds may be present. - `location_samples` ElectionalToleranceFrontierLocationSample[], required - `id` string, required - `bearing_degrees` number, required - `distance_km` number, required - `lat` number, required - `lon` number, required - `samples` ElectionalToleranceFrontierSample[], required - `id` string, required - `time_sample_id` string, required - `time_offset_seconds` integer, required - `at_utc` string, date-time, required: Normalized UTC timestamp; fractional seconds may be present. - `location_sample_id` string, required - `bearing_degrees` number, nullable, required - `distance_km` number, required - `lat` number, required - `lon` number, required - `status` 'available' | 'unavailable', required - `reason_code` 'undefined_for_input_geometry', nullable, required - `matches_all` boolean, nullable, required - `criteria` ElectionalRobustnessAuditEvaluation[], nullable, required - `id` string, required - `kind` 'moon_signs' | 'moon_phase_sectors' | 'mercury_motion' | 'ascendant_signs' | 'aspect', required - `matched` boolean, required - `observed` union, required - 'Aries' | 'Taurus' | 'Gemini' | 'Cancer' | 'Leo' | 'Virgo' | 'Libra' | 'Scorpio' | 'Sagittarius' | 'Capricorn' | 'Aquarius' | 'Pisces' - 'new_moon' | 'waxing_crescent' | 'first_quarter' | 'waxing_gibbous' | 'full_moon' | 'waning_gibbous' | 'last_quarter' | 'waning_crescent' - 'direct' | 'retrograde' | 'stationary' - number - `criteria` ElectionalToleranceFrontierCriterion[], required - `id` string, required - `kind` 'moon_signs' | 'moon_phase_sectors' | 'mercury_motion' | 'ascendant_signs' | 'aspect', required - `center_match` boolean, nullable, required - `time` object, required - `earlier` ElectionalToleranceFrontierEvidence, required - `status` 'not_evaluable_at_center' | 'center_does_not_match' | 'failure_observed' | 'no_failure_observed_within_limit' | 'indeterminate_within_limit', required - `limit` number, required - `step` number, required - `last_observed_matching_value` number, nullable, required - `first_observed_failing_value` number, nullable, required - `first_unavailable_value` number, nullable, required - `all_samples_evaluable` boolean, required - `sample_ids` string[], required - `later` ElectionalToleranceFrontierEvidence, required - `status` 'not_evaluable_at_center' | 'center_does_not_match' | 'failure_observed' | 'no_failure_observed_within_limit' | 'indeterminate_within_limit', required - `limit` number, required - `step` number, required - `last_observed_matching_value` number, nullable, required - `first_observed_failing_value` number, nullable, required - `first_unavailable_value` number, nullable, required - `all_samples_evaluable` boolean, required - `sample_ids` string[], required - `location` ElectionalToleranceFrontierLocationEvidence[], required - `bearing_id` 'north' | 'northeast' | 'east' | 'southeast' | 'south' | 'southwest' | 'west' | 'northwest', required - `bearing_degrees` number, required - `status` 'not_evaluable_at_center' | 'center_does_not_match' | 'failure_observed' | 'no_failure_observed_within_limit' | 'indeterminate_within_limit', required - `limit` number, required - `step` number, required - `last_observed_matching_value` number, nullable, required - `first_observed_failing_value` number, nullable, required - `first_unavailable_value` number, nullable, required - `all_samples_evaluable` boolean, required - `sample_ids` string[], required - `summary` object, required - `criterion_count` integer, required - `center_matching_criterion_count` integer, required - `center_failing_criterion_count` integer, required - `center_not_evaluable_criterion_count` integer, required - `criteria_with_time_failure_observed` integer, required - `criteria_with_location_failure_observed` integer, required - `nearest_observed_time_failure_seconds` number, nullable, required - `nearest_observed_location_failure_km` number, nullable, required - `sample_count` 101, required - `available_sample_count` integer, required - `unavailable_sample_count` integer, required - `fallback` object, required - `performed` unknown, required - `selected_system` unknown, required - `metadata` object, required - `model` 'cosmicephemeris-electional-tolerance-frontier-v1', required - `ephemeris` 'JPL-DE440', required - `sampling_method` 'ten_outward_steps_on_two_time_directions_and_eight_location_bearings', required - `time_axis` 'absolute_seconds_from_resolved_center_instant', required - `steps_per_direction` 10, required - `time_direction_count` 2, required - `location_bearing_count` 8, required - `time_sample_count` 20, required - `location_sample_count` 80, required - `center_shared` unknown, required - `full_factorial` unknown, required - `filter_logic` 'all_selected_filters_must_match', required - `exact_boundary_guarantee` unknown, required - `continuous_time_guarantee` unknown, required - `entire_disk_guarantee` unknown, required - `monotonicity_assumption` unknown, required - `statistical_confidence` unknown, required - `max_chart_evaluations` 101, required - `max_criterion_evaluations` 808, required - `ranking` unknown, required - `recommendations` unknown, required - `interpretations` unknown, required - `predictions` unknown, required - `request_time_network` unknown, required - `receipt` CalculationReceipt - `schema` 'cosmicephemeris-calculation-receipt-v1', required - `kid` string, required - `algorithm` 'Ed25519', required - `canonicalization` 'cosmicephemeris-canonical-data-v1', required - `input_normalization` 'public-request-canonical-data-v1', required - `route` string, required - `release` string, required - `issued_at` string, date-time, required - `normalized_input_sha256` string, required - `result_sha256` string, required - `calculation_profile` object, required - `service_dataset_versions` object, required - `calculation_fingerprint` string, required - `verification_uri` string, required - `signature` string, required - HistoricalElectionalToleranceFrontierElectionalToleranceFrontierResponse - `schema` 'cosmicephemeris-historical-calculation-v1', required - `status` 'historical', required - `type` 'electional-tolerance-frontier', required - `input` HistoricalElectionalToleranceFrontierRequest, required: Explicit historical mode, 1000 BCE (BC)–2500 CE (AD). No year zero, implicit calendar, UTC or IANA zone. Preserve tool-specific mathematical, geographic and search limits; calendar/time conventions and estimated Delta-T are not certified historical accuracy. - `event` HistoricalBirthInput, required - `date` HistoricalDate, required: Explicit civil date, 1000 BCE (BC)–2500 CE (AD); no year zero. Calendar validity is checked by the server. Available only on documented connected historical operations, with explicit UT1/fixed-offset conventions. - `year` integer, required - `era` 'BCE' | 'CE', required: Display BCE (BC) / CE (AD); API values remain BCE / CE. No year zero. - `month` integer, required - `day` integer, required - `calendar` 'proleptic_gregorian' | 'proleptic_julian', required: Explicit choice; applies the selected calendar rules throughout history without a regional adoption switch. - `time` string, required: Explicit HH:MM[:SS]; whole seconds only, no leap seconds. Normalized helper output includes seconds. - `timezone` string, required: Explicit UT1 or fixed offset UT1+/-HH:MM[:SS], within 14 hours. Local clock minus offset yields UT1, not UTC. No IANA timezone inference. Original offset spelling is preserved. - `lat` number, required - `lon` number, required - `profile` union, required - object - `zodiac` 'tropical', required - object - `zodiac` 'sidereal', required - `ayanamsa` 'lahiri' | 'raman' | 'krishnamurti' | 'fagan_bradley' | 'yukteshwar' | 'sassanian' | 'true_chitra' | 'true_revati' | 'true_pushya' | 'galactic_center_0_sagittarius' | 'galactic_alignment_mardyks', required - `filters` object, required - `moon_signs` string[] - `moon_phase_sectors` string[] - `mercury_motion` 'direct' | 'retrograde' - `ascendant_signs` string[] - `aspects` object[] - `body_a` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `body_b` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto', required - `aspect` 'conjunction' | 'sextile' | 'square' | 'trine' | 'opposition', required - `max_orb_degrees` number, required - `max_time_shift_minutes` integer, required - `max_location_radius_km` number, required - `result` object, required: Complete historical calculation adapter result. Times are explicit UT1 date records, never UTC strings; derived times may include fractional seconds and years outside the input range. - `metadata` object, required - `time_standard` 'UT1', required - `historical_accuracy_certified` unknown, required - `warnings` string[], required ## Other responses - `400`: Invalid request, malformed JSON, out-of-range date/location, unknown model, invalid timezone or ambiguous/nonexistent clock-change time. Invalid attempts reaching quota reservation consume one unit. - `401`: Missing, invalid, revoked API key or unavailable activated key owner. Dashboard cookies do not authenticate calculation routes. - `403`: Origin not allowed by production CORS policy. Server-to-server requests can omit Origin. - `429`: Monthly quota exhausted, per-user two-request concurrency reached, or nginx rate/connection admission refused. Retry-After: 2 is sent for application per-user concurrency only, not a promise that monthly quota resets in two seconds. - `502`: Engine unavailable, unsuccessful internal server response or invalid upstream JSON. No engine internals are exposed. - `503`: Four-request global calculation pool full (Retry-After: 2), maintenance or upstream service unavailable. - `504`: Application engine timeout: 15 seconds normally; planetary events, house ingresses, aspect windows, event calendar, eclipse geometry, electional search, and event-rule search use 30 seconds; Nakshatra Timeline plus the explicitly enumerated readiness, robustness, location, uncertainty, and electional-audit family use 60 seconds. Timer includes response-body parsing; an admitted timeout consumes quota. --- [API](https://skmtc.dev/cosmicephemeris/apis/cosmic-ephemeris-calculation-api.md) · [All operations](https://skmtc.dev/cosmicephemeris/apis/cosmic-ephemeris-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cosmicephemeris/apis/cosmic-ephemeris-calculation-api/revisions/f041e924cea3?raw)