Back to Docs

Table Mode

Table Mode

QUERY MODEresponse_mode=table

Add response_mode=table on chart endpoints to receive row-oriented tables for points, angles, houses, and aspects instead of the nested chart payload.

Chart endpoints still require x-api-key. response_mode=table is additive and only works on chart routes.

When To Use It

Table mode is useful for astrologer-facing UIs, compact dashboards, or cases where you want formatted longitude rows without traversing the full nested chart structure.

It keeps the same progression basis and input metadata, but swaps the main chart blocks for flatter table-oriented collections.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/tertiary?response_mode=table" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "User",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "AUTO"
    }
  },
  "tertiary_progression": {
    "target_date": "2026-03-30"
  }
}'

Real API Response Example

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

{
  "meta": {
    "endpoint": "progressions_chart",
    "version": "v1",
    "system": "tertiary",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "calculation_method": "tertiary_progressions_day_for_lunar_month",
    "target_date": "2026-03-30",
    "target_datetime": "2026-03-30T00:00:00Z",
    "orb_deg": 1,
    "generated_at": "2026-04-14T15:54:57Z"
  },
  "progression_basis": {
    "age_years_decimal": 36.240337,
    "progressed_days_after_birth": 448.230141,
    "natal_datetime_utc": "1990-01-01T12:00:00Z",
    "progressed_datetime_utc": "1991-03-25T17:31:24Z"
  },
  "tables": {
    "points": [
      {
        "point": "sun",
        "name": "Sun",
        "longitude_deg": 4.567463,
        "longitude_text": "04°34' Ari",
        "sign": {
          "name": "Aries",
          "index": 0,
          "abbr": "Ari"
        },
        "position_in_sign_deg": 4.567463,
        "house": 7,
        "retrograde": false
      },
      {
        "point": "moon",
        "name": "Moon",
        "longitude_deg": 126.855787,
        "longitude_text": "06°51' Leo",
        "sign": {
          "name": "Leo",
          "index": 4,
          "abbr": "Leo"
        },
        "position_in_sign_deg": 6.855787,
        "house": 11,
        "retrograde": false
      },
      {
        "point": "mercury",
        "name": "Mercury",
        "longitude_deg": 23.040506,
        "longitude_text": "23°02' Ari",
        "sign": {
          "name": "Aries",
          "index": 0,
          "abbr": "Ari"
        },
        "position_in_sign_deg": 23.040506,
        "house": 8,
        "retrograde": false
      },
      {
        "point": "venus",
        "name": "Venus",
        "longitude_deg": 38.239634,
        "longitude_text": "08°14' Tau",
        "sign": {
          "name": "Taurus",
          "index": 1,
          "abbr": "Tau"
        },
        "position_in_sign_deg": 8.239634,
        "house": 8,
        "retrograde": false
      },
      {
        "point": "mars",
        "name": "Mars",
        "longitude_deg": 85.667457,
        "longitude_text": "25°40' Gem",
        "sign": {
          "name": "Gemini",
          "index": 2,
          "abbr": "Gem"
        },
        "position_in_sign_deg": 25.667457,
        "house": 9,
        "retrograde": false
      }
    ],
    "angles": [
      {
        "angle": "ascendant",
        "longitude_deg": 176.756,
        "longitude_text": "26°45' Vir",
        "sign": {
          "name": "Virgo",
          "index": 5,
          "abbr": "Vir"
        },
        "position_in_sign_deg": 26.756
      },
      {
        "angle": "midheaven",
        "longitude_deg": 85.778,
        "longitude_text": "25°47' Gem",
        "sign": {
          "name": "Gemini",
          "index": 2,
          "abbr": "Gem"
        },
        "position_in_sign_deg": 25.778
      },
      {
        "angle": "descendant",
        "longitude_deg": 356.756,
        "longitude_text": "26°45' Pis",
        "sign": {
          "name": "Pisces",
          "index": 11,
          "abbr": "Pis"
        },
        "position_in_sign_deg": 26.756
      },
      {
        "angle": "ic",
        "longitude_deg": 265.778,
        "longitude_text": "25°47' Sag",
        "sign": {
          "name": "Sagittarius",
          "index": 8,
          "abbr": "Sag"
        },
        "position_in_sign_deg": 25.778
      }
    ],
    "aspects": [
      {
        "relation": "progressed_to_natal",
        "point_1": "sun",
        "point_2": "jupiter",
        "aspect_name": "square",
        "aspect_angle_deg": 90,
        "orb_deg": 0.581,
        "separation_deg": 90.581,
        "applying": true,
        "exact": false,
        "exact_date": "2026-04-16T08:00:56Z",
        "interpretation_key": "progressed_sun_square_natal_jupiter"
      },
      {
        "relation": "progressed_to_natal",
        "point_1": "neptune",
        "point_2": "saturn",
        "aspect_name": "conjunction",
        "aspect_angle_deg": 0,
        "orb_deg": 0.946,
        "separation_deg": 0.946,
        "applying": false,
        "exact": false,
        "interpretation_key": "progressed_neptune_conjunction_natal_saturn"
      },
      {
        "relation": "progressed_to_natal",
        "point_1": "neptune",
        "point_2": "pluto",
        "aspect_name": "sextile",
        "aspect_angle_deg": 60,
        "orb_deg": 0.49,
        "separation_deg": 59.51,
        "applying": false,
        "exact": false,
        "interpretation_key": "progressed_neptune_sextile_natal_pluto"
      },
      {
        "relation": "progressed_to_natal",
        "point_1": "moon",
        "point_2": "venus",
        "aspect_name": "opposition",
        "aspect_angle_deg": 180,
        "orb_deg": 0.634,
        "separation_deg": 179.366,
        "applying": false,
        "exact": false,
        "interpretation_key": "progressed_moon_opposition_natal_venus"
      },
      {
        "relation": "progressed_to_natal",
        "point_1": "mars",
        "point_2": "descendant",
        "aspect_name": "trine",
        "aspect_angle_deg": 120,
        "orb_deg": 0.723,
        "separation_deg": 119.277,
        "applying": false,
        "exact": false,
        "exact_date": "2026-02-16T08:23:26Z",
        "interpretation_key": "progressed_mars_trine_natal_descendant"
      },
      {
        "relation": "progressed_to_natal",
        "point_1": "mars",
        "point_2": "ascendant",
        "aspect_name": "sextile",
        "aspect_angle_deg": 60,
        "orb_deg": 0.723,
        "separation_deg": 60.723,
        "applying": false,
        "exact": false,
        "exact_date": "2026-02-16T08:23:26Z",
        "interpretation_key": "progressed_mars_sextile_natal_ascendant"
      }
    ],
    "events": []
  }
}

Related Docs