{
  "info": {
    "_postman_id": "fab3ea8d-84ce-4c4e-9841-6c5b43dc4d2a",
    "name": "Astrocartography Collection",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_exporter_id": "52126420",
    "_collection_link": "https://go.postman.co/collection/52126420-fab3ea8d-84ce-4c4e-9841-6c5b43dc4d2a?source=collection_link"
  },
  "item": [
    {
      "name": "Travel (Plot Coordinates)",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"day\": 22,\n  \"month\": 8,\n  \"year\": 1999,\n  \"hour\": 18,\n  \"min\": 50,\n  \"second\": 0,\n  \"tzone\": 5.5,\n  \"lat\": 19.0759837,\n  \"lon\": 72.8776559,\n  \"include_parans\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/travel",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "travel"
          ]
        },
        "description": "Returns all of a chart's astrocartography line coordinates so you can draw a full ACG map.\n\n**What it does** — For each planet it computes where on Earth that planet is exactly on one of the four angles — the MC/IC meridians (the longitudes where the planet is overhead or underfoot) and the AC/DC curves (the winding lines where it's rising or setting). Plotting these lines shows which places amplify each planet's themes for the person. Use it to render an interactive relocation/astrocartography map.\n\n**Send** — Standard `birth_details` (see the collection overview), all nine required. `include_parans` (boolean, default `false`) — set `true` to also return the latitude-crossing paran lines. Longitudes are reported east-positive.\n\n**Returns** — A JSON object with `meta` and a `lines` array, one entry per planet. Each entry holds that planet's four angle lines: the `asc`/`dsc` are `curve` objects with a `points` array of `{latitude_deg, longitude_deg}` samples (stepped by latitude) tracing the rising/setting curve, while the MC/IC come back as `meridian` objects carrying a single `longitude_deg`. When `include_parans=true`, paran latitude crossings are included in the response.\n\n**Errors** — Invalid, missing, or out-of-range input returns `400` with the offending field in `field_errors`; see the collection overview for the full error format."
      }
    },
    {
      "name": "Category Based Location",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"day\": 22,\n  \"month\": 8,\n  \"year\": 1999,\n  \"hour\": 18,\n  \"min\": 50,\n  \"second\": 0,\n  \"tzone\": 5.5,\n  \"lat\": 19.0759837,\n  \"lon\": 72.8776559,\n  \"include_parans\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/location/:category",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "location",
            ":category"
          ],
          "variable": [
            {
              "key": "category",
              "value": "LOVE",
              "description": "Life category: LOVE, CAREER, MONEY, HEALTH, SPIRITUALITY, ADVENTURE, CREATIVITY, POWER, COMMUNICATION"
            }
          ]
        },
        "description": "Returns only the astrocartography lines for the planets tied to a chosen life category.\n\n**What it does** — Maps a life theme (love, career, money, etc.) to its associated planets and returns just those planets' angle lines, so you can highlight the places on Earth that favor that area of life rather than drawing the whole map. Use it for themed \"best places for love/career\" map views.\n\n**Send** — Standard `birth_details` (see the collection overview), all nine required. Path parameter `category` — the life area to filter by, e.g. `LOVE`, `CAREER`, `MONEY`, `HEALTH`, `SPIRITUALITY`, `ADVENTURE`, `CREATIVITY`, `POWER`, `COMMUNICATION`.\n\n**Returns** — A JSON object with `meta`, the echoed `category`, and a `lines` array structured exactly like the Travel endpoint but limited to the category's planets: each entry carries that planet's `asc`/`dsc` rising/setting curves (a `points` list of `{latitude_deg, longitude_deg}`) and MC/IC meridian longitudes. Longitudes are east-positive.\n\n**Errors** — An unknown `category` or invalid/missing `birth_details` returns `400` with the offending field in `field_errors`; see the collection overview for the full error format."
      }
    },
    {
      "name": "Planetary Line Report",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"day\": 22,\n  \"month\": 8,\n  \"year\": 1999,\n  \"hour\": 18,\n  \"min\": 50,\n  \"second\": 0,\n  \"tzone\": 5.5,\n  \"lat\": 19.0759837,\n  \"lon\": 72.8776559,\n  \"include_parans\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/planetary-line/:category/:planet",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "planetary-line",
            ":category",
            ":planet"
          ],
          "variable": [
            {
              "key": "category",
              "value": "MC",
              "description": "Angle type: MC, IC, AC, or DC"
            },
            {
              "key": "planet",
              "value": "MOON",
              "description": "Planet: SUN through PLUTO"
            }
          ]
        },
        "description": "Returns the geometry of one single planet-and-angle astrocartography line.\n\n**What it does** — Computes just one line: a specific planet on a specific angle (its Midheaven, IC, Ascendant, or Descendant line). Use it when you want the coordinates of one line in isolation rather than a whole map.\n\n**Send** — Standard `birth_details` (see the collection overview), all nine required. Path parameter `category` — the line/angle type: `MC`, `IC`, `AC`, or `DC`. Path parameter `planet` — the body, `SUN` through `PLUTO`.\n\n**Returns** — A JSON object with `meta` (engine info, the latitude step, the east-positive longitude convention, and the reference location) and a `line` object. For MC/IC the line is a `meridian` with a single `longitude_deg`, the `object` (planet) name, and the `zenith_latitude_deg` where the planet is directly overhead. For AC/DC it comes back as a `curve` with a `points` array of `{latitude_deg, longitude_deg}` samples tracing the rising/setting line.\n\n**Errors** — A bad `category`/`planet` or invalid `birth_details` returns `400` with the offending field in `field_errors`; see the collection overview for the full error format."
      }
    },
    {
      "name": "Natal ACG Map",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"day\": 30,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 14,\n  \"min\": 30,\n  \"second\": 0,\n  \"tzone\": 5.5,\n  \"lat\": 28.6139,\n  \"lon\": 77.209,\n  \"place_name\": \"Delhi\",\n  \"options\": {\n    \"size\": 1200,\n    \"theme\": \"classic_light\",\n    \"view\": \"world\",\n    \"planets\": [\n      \"sun\",\n      \"moon\",\n      \"jupiter\"\n    ],\n    \"lines\": [\n      \"mc\",\n      \"ic\",\n      \"asc\",\n      \"dsc\"\n    ],\n    \"labels\": \"all\",\n    \"show\": {\n      \"land\": true,\n      \"graticule\": true,\n      \"legend\": true,\n      \"zenith\": true,\n      \"birth_place\": true,\n      \"stamp\": true\n    },\n    \"output\": \"json\",\n    \"include_meta\": true\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/render/map",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "render",
            "map"
          ]
        },
        "description": "The Natal ACG Map API creates an SVG astrocartography map from birth details. It draws every planet's MC, IC, ASC, and DSC line on a world or regional map, including zenith points and the birthplace marker. \n\nMC and ASC lines are solid, while IC and DSC lines are dashed. The SVG can include land, a graticule, legend, stamp, line labels, and a fully themed map frame. \n\nThis API is the complete natal-map layer of Astrocartography. Use the Category ACG Map API when you need a map focused on one life area with ranked places.\n\nProvide birth details and optional map-rendering options to generate a natal astrocartography SVG map.\n\n**Parameters**\n- `day` (number, required): Birth day, 1–31. Alias: birth_details.date or day.\n- `month` (number, required): Birth month, 1–12.\n- `year` (number, required): Birth year.\n- `hour` (number, required): Birth hour at the birthplace, 0–23.\n- `min` (number, required): Birth minute, 0–59. Alias: min.\n- `second` (number, optional): Optional birth second, 0–59. Alias: sec.\n- `tzone` (number, required): Hours east of UTC, -24 to 24. Alias: tzone.\n- `lat` (number, required): Birth latitude, -90 to 90. Alias: lat.\n- `lon` (number, required): Birth longitude, -180 to 180. Alias: lon.\n- `place_name` (string, optional): Optional place name shown in the map stamp instead of coordinates.\n- `options` (object, optional): Optional rendering controls: size 480–4000, theme, palette, regional view, planet and line filters, labels, show flags, caption, font family, output (json or svg), include_meta, and latitude_step."
      }
    },
    {
      "name": "Transit ACG Map",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"target_date\": \"2026-10-23\",\n  \"target_time\": \"12:00\",\n  \"tzone\": 0,\n  \"options\": {\n    \"size\": 1200,\n    \"theme\": \"classic_light\",\n    \"view\": \"world\",\n    \"planets\": [\n      \"sun\",\n      \"moon\",\n      \"jupiter\"\n    ],\n    \"lines\": [\n      \"mc\",\n      \"ic\",\n      \"asc\",\n      \"dsc\"\n    ],\n    \"labels\": \"all\",\n    \"show\": {\n      \"land\": true,\n      \"graticule\": true,\n      \"legend\": true,\n      \"zenith\": true,\n      \"night\": true,\n      \"stamp\": true\n    },\n    \"output\": \"json\",\n    \"include_meta\": true\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/render/transits",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "render",
            "transits"
          ]
        },
        "description": "The Transit ACG Map API creates a sky-of-the-moment astrocartography SVG map without birth data. It shows where every planet is rising, setting, culminating, and anti-culminating at the requested moment. \n\nThe night side of Earth is shaded from the Sun's own lines, so the Sun's ASC and DSC curves sit exactly on the day-night edge. The same request is identical for every caller at a moment and is well suited to caching. \n\nThis API is the real-time map layer of Astrocartography. It supports the same themes, line filters, labels, views, and SVG or JSON output options as the natal map.\n\nProvide an optional date, time, and timezone offset to generate a real-time astrocartography SVG map.\n\n**Parameters**\n- `target_date` (string, optional): Optional target date in YYYY-MM-DD format. Default: today at timezone_offset.\n- `target_time` (string, optional): Optional target time in HH:MM or HH:MM:SS format. Default: 12:00.\n- `tzone` (number, optional): Optional timezone offset, -14 to 14. The stamp prints it as UTC±hh:mm.\n- `options` (object, optional): Optional rendering controls: size 480–4000, theme, palette, regional view, planet and line filters, labels, show flags including night, caption, font family, output (json or svg), and include_meta."
      }
    },
    {
      "name": "Category ACG Map",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "x-astrologyapi-key",
            "value": "{{access_token}}",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"category\": \"career\",\n  \"top_n\": 6,\n  \"day\": 30,\n  \"month\": 8,\n  \"year\": 1990,\n  \"hour\": 14,\n  \"min\": 30,\n  \"second\": 0,\n  \"tzone\": 5.5,\n  \"lat\": 28.6139,\n  \"lon\": 77.209,\n  \"place_name\": \"Delhi\",\n  \"options\": {\n    \"size\": 1200,\n    \"theme\": \"classic_light\",\n    \"view\": \"world\",\n    \"labels\": \"all\",\n    \"show\": {\n      \"land\": true,\n      \"graticule\": true,\n      \"legend\": true,\n      \"zenith\": true,\n      \"ranked_list\": true,\n      \"birth_place\": true,\n      \"stamp\": true\n    },\n    \"output\": \"json\",\n    \"include_meta\": true\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://json.astrologyapi.com/v1/acg/render/category",
          "protocol": "https",
          "host": [
            "json",
            "astrologyapi",
            "com"
          ],
          "path": [
            "v1",
            "acg",
            "render",
            "category"
          ]
        },
        "description": "The Category ACG Map API creates an SVG astrocartography map for one life area. It draws only the planetary lines that matter for the selected category, orders them by importance, displays caution lines as dotted, and pins ranked places for that goal. \n\nCategories include career, love, money, health, home and family, creativity, spirituality, education, reinvention, adventure, and communication. Stronger lines are thicker and have a wider glow, while pinned places use the same goal scores as the relocation reports and PDFs. \n\nThis API is the goal-focused map layer of Astrocartography. It turns birth details into a readable visual guide for one specific area of life.\n\nProvide a category, birth details, and optional rendering controls to generate a ranked life-area astrocartography SVG map.\n\n**Parameters**\n- `category` (string, required): Required life area: career, love, money, health, home_family, creativity, spirituality, education, reinvention, adventure, or communication.\n- `top_n` (number, optional): Optional number of ranked places to pin, from 0 to 12. Use 0 for no place pins.\n- `day` (number, required): Birth day, 1–31. Alias: birth_details.date or day.\n- `month` (number, required): Birth month, 1–12.\n- `year` (number, required): Birth year.\n- `hour` (number, required): Birth hour at the birthplace, 0–23.\n- `min` (number, required): Birth minute, 0–59. Alias: min.\n- `second` (number, optional): Optional birth second, 0–59. Alias: sec.\n- `tzone` (number, required): Hours east of UTC, -24 to 24. Alias: tzone.\n- `lat` (number, required): Birth latitude, -90 to 90. Alias: lat.\n- `lon` (number, required): Birth longitude, -180 to 180. Alias: lon.\n- `place_name` (string, optional): Optional place name shown in the map stamp instead of coordinates.\n- `options` (object, optional): Optional rendering controls: size, theme, palette, view, labels, show flags including ranked_list, caption, font family, output, include_meta, latitude_step, line_orb_km, and paran_orb_km."
      }
    }
  ]
}
