# Voda Astro Data API — Full Machine Client Guide

Provider: voda
Category: data
Base URL: https://astro.dutchdata.io

Send an unpaid request to receive authoritative MPP and x402 HTTP 402 offers.
MPP credentials use Authorization; x402 credentials use Payment-Signature.

## GET /api/locations/count

Total number of location records available

Price: $0.01 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/locations/count
Request schema: `{"type":"object","properties":{}}`
Request example: `{}`
Response schema: `{"type":"object","properties":{"count":{"type":"integer","minimum":0}},"required":["count"]}`
Response example: `{"count":245789}`

## GET /api/locations/countries

List all countries with location coverage

Price: $0.50 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/locations/countries
Request schema: `{"type":"object","properties":{}}`
Request example: `{}`
Response schema: `{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}}},"required":["countries"]}`
Response example: `{"countries":["CA","GB","US"]}`

## GET /api/locations/countries/{country_code}/regions

List a country's regions/states

Price: $0.50 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/locations/countries/US/regions
Request schema: `{"type":"object","properties":{"country_code":{"type":"string"}},"required":["country_code"]}`
Request example: `{}`
Response schema: `{"type":"object","properties":{"regions":{"type":"array","items":{"type":"string"}}},"required":["regions"]}`
Response example: `{"regions":["CA","NY","WA"]}`

## GET /api/locations/{country_code}/{region_code}/search

Fuzzy-search cities within a country region

Price: $0.50 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/locations/US/NY/search
Request schema: `{"type":"object","properties":{"country_code":{"type":"string"},"region_code":{"type":"string"},"query":{"type":"string"},"limit":{"type":"integer","minimum":1}},"required":["country_code","region_code"]}`
Request example: `{}`
Response schema: `{"type":"array","items":{"$ref":"#/components/schemas/RichLocation"}}`
Response example: `[{"id":5128581,"city":"New York","region_code":"NY","country_code":"US","lat":40.71427,"lon":-74.00597,"timezone":"America/New_York","population":8804190}]`

## GET /api/locations/{country_code}/{region_code}/{city}

Rich location record with coordinates and timezone

Price: $0.50 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/locations/US/NY/New%20York
Request schema: `{"type":"object","properties":{"country_code":{"type":"string"},"region_code":{"type":"string"},"city":{"type":"string"}},"required":["country_code","region_code","city"]}`
Request example: `{}`
Response schema: `{"type":"object","properties":{"location":{"$ref":"#/components/schemas/RichLocation"}},"required":["location"]}`
Response example: `{"location":{"id":5128581,"city":"New York","region_code":"NY","country_code":"US","lat":40.71427,"lon":-74.00597,"timezone":"America/New_York","population":8804190}}`

## GET /api/full_chart/dt/{unix_ms_utc}

Full astrological chart for a UTC instant (planets, houses, aspects)

Price: $0.50 USD
Response MIME: application/json
Example URL: https://astro.dutchdata.io/api/full_chart/dt/1767225600000
Request schema: `{"type":"object","properties":{"unix_ms_utc":{"type":"integer","minimum":0}},"required":["unix_ms_utc"]}`
Request example: `{}`
Response schema: `{"type":"array","items":{"type":"object","properties":{"planet":{"type":"integer","minimum":0,"maximum":11},"sign":{"type":"integer","minimum":0,"maximum":11},"deg_min_sec":{"type":"string"},"house_num":{"type":"integer","minimum":0,"maximum":12},"is_rx":{"type":"boolean"},"lat":{"type":"number"}},"required":["planet","sign","deg_min_sec","house_num","is_rx","lat"]}}`
Response example: `[{"planet":0,"sign":9,"deg_min_sec":"10º15'30\"","house_num":1,"is_rx":false,"lat":0.0001}]`

## POST /api/mundane_chart

Mundane (transit-to-transit) aspect time series over a date range

Price: $0.50 USD
Response MIME: application/msgpack
Example URL: https://astro.dutchdata.io/api/mundane_chart
Request schema: `{"type":"object","properties":{"aspect_context":{"type":"integer","enum":[0,1,2]},"contact_uuid":{"type":["string","null"],"format":"uuid"},"y_0":{"type":"integer"},"m_0":{"type":"integer","minimum":1,"maximum":12},"d_0":{"type":"integer","minimum":1,"maximum":31},"y_1":{"type":"integer"},"m_1":{"type":"integer","minimum":1,"maximum":12},"d_1":{"type":"integer","minimum":1,"maximum":31},"q":{"type":"integer","minimum":1},"t_f1":{"type":"array","items":{"type":"integer","minimum":0,"maximum":11}},"n_f2":{"type":"array","items":{"type":"integer","minimum":0,"maximum":11}}},"required":["aspect_context","y_0","m_0","d_0","y_1","m_1","d_1","q","t_f1","n_f2"]}`
Request example: `{
  "aspect_context": 1,
  "contact_uuid": null,
  "y_0": 2026, "m_0": 7, "d_0": 1,
  "y_1": 2026, "m_1": 8, "d_1": 1,
  "q": 24,
  "t_f1": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
  "n_f2": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
}`
Response schema: `{"type":"object","properties":{"data":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"labels":{"type":"array","items":{"type":"string"}},"metadata":{"type":"array","items":{"type":"array","items":{"type":"object"}}}},"required":["data","labels","metadata"]}`
Response example: `{"data":[[0.0]],"labels":["2026-07-01T00:00:00Z"],"metadata":[[]]}`

## POST /api/transit_chart/inline

Transit aspect time series with birth data supplied inline (no account)

Price: $0.50 USD
Response MIME: application/msgpack
Example URL: https://astro.dutchdata.io/api/transit_chart/inline
Request schema: `{"type":"object","properties":{"contact":{"anyOf":[{"$ref":"#/components/schemas/Contact"},{"type":"null"}]},"chart":{"$ref":"#/components/schemas/ChartRequest"}},"required":["chart"]}`
Request example: `{
  "contact": {
    "name": "Example",
    "is_main": false,
    "relationship": "self",
    "birth": {
      "year": 1990, "month": 6, "date": 15, "hour": 14, "minute": 30,
      "timezone": "America/New_York",
      "location": {
        "country": "US", "state": "NY", "city": "New York",
        "lat": 40.7128, "lon": -74.006
      }
    }
  },
  "chart": {
    "aspect_context": 0,
    "contact_uuid": null,
    "y_0": 2026, "m_0": 7, "d_0": 1,
    "y_1": 2026, "m_1": 8, "d_1": 1,
    "q": 24,
    "t_f1": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
    "n_f2": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
  }
}`
Response schema: `{"type":"object","properties":{"data":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"labels":{"type":"array","items":{"type":"string"}},"metadata":{"type":"array","items":{"type":"array","items":{"type":"object"}}}},"required":["data","labels","metadata"]}`
Response example: `{"data":[[0.0]],"labels":["2026-07-01T00:00:00Z"],"metadata":[[]]}`