Human Design

Human Design Extended Placements

Human Design address for points beyond the 13 bodygraph bodies, at the Personality instant and at the Design instant (88° of solar arc earlier), both at the birth location.

Choose what to compute with include: bodies (asteroids, Chiron, Lilith, Vertex, the mean node and the Uranian set), angles (ASC, DSC, MC, IC), lots (the seven Hermetic Lots, cast in the sect of each instant's own chart — Sun above the horizon is a day chart), stars (fixed stars, evaluated at each epoch) and kernel_bodies (opt-in: the kernel-backed catalog of asteroids, centaurs and trans-Neptunian objects, named as on the /acg endpoints; a requested body whose kernel does not cover the Personality or Design instant refuses the whole request with a 422). bodies alone is the default. Stars need star_groups (see GET /catalogs/fixed-stars/groups), star_names (catalog slugs, see GET /catalogs/fixed-stars), or both; the result is their union, de-duplicated and in catalog order.

These points never enter the bodygraph: no definition, channels, centers, type, authority or cross. Use /human-design/chart for those.

Access: any API key can call this route. Every key receives gate and line for each point. longitude, color, tone and base (and a star's ecliptic latitude) are returned only on Pro plans and above; on other keys they are omitted and metadata.deep_fields is false.

Pricing: priced by what you ask for, once per request (Personality and Design together): extended bodies 3 credits, angles 1, Hermetic Lots 2, fixed stars 3 per star group plus 1 per named star (capped at 20), kernel bodies 1 per named body capped at 20 (naming none costs 20). The smallest request (angles only) is 1 credit. The price is read from the request before any compute, and a rejected request is refunded.

post/human-design/extended

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/human-design/extended
  • 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

Request body

birth_datetime_localstring

Naive local wall-clock birth datetime (YYYY-MM-DDTHH:MM:SS, no zone suffix), resolved by the server. Mutually exclusive with birth_datetime_utc.

birth_datetime_utcstring date-time

Birth instant as an RFC 3339 datetime, e.g. '1987-07-15T14:01:00Z'. Mutually exclusive with birth_datetime_local.

bodiesstring[]

Extended bodies to return, by name (case-insensitive). Omit for the whole extended roster. Only valid when include contains bodies. An unknown name is rejected and the valid names are listed.

includestring[]

Components to compute: bodies, angles, lots, stars, kernel_bodies. Each is priced separately. kernel_bodies is opt-in: the kernel-backed catalog (asteroids, centaurs and trans-Neptunian objects beyond the bodies roster, as named on the /acg endpoints, e.g. Eros (asteroid)); it is never included unless asked for.

kernel_bodiesstring[]

Kernel-catalog bodies to return, by ACG name (case-insensitive), e.g. Eris, Eros (asteroid). Omit for the whole kernel catalog. Only valid when include contains kernel_bodies. An unknown name is rejected and the valid names are listed. Priced 1 credit per distinct body, capped at 20 (naming none costs the cap). Bodies with their own kernel cover 1600 to 2200 CE (the rest 1550 to 2650 CE); a birth whose Personality or Design instant falls outside a requested body's window is refused with a 422, never approximated. The Design instant is about 88 days before birth.

latitudenumber double

Birth latitude in decimal degrees, within [-90, 90]. Required.

longitudenumber double

Birth longitude in decimal degrees, within [-180, 180]. Required.

star_groupsstring[]

Fixed-star groups to return (names from GET /catalogs/fixed-stars/groups). Only valid when include contains stars, which needs star_groups, star_names or both. Priced per distinct group.

star_namesstring[]

Fixed stars to return by catalog slug (case-insensitive; spaces read as underscores), e.g. rigil_kentaurus, rasalhague, elnath, altair. Slugs are listed at GET /catalogs/fixed-stars. Only valid when include contains stars. May be combined with star_groups: the result is the union, de-duplicated and in catalog order. An unknown slug is rejected with a 422 that lists the valid slugs. Priced 1 credit per distinct name, capped at 20.

Example request

{
  "birth_datetime_local": "1985-03-20T08:15:00",
  "include": [
    "bodies",
    "angles",
    "lots",
    "stars"
  ],
  "latitude": 37.7749,
  "longitude": -122.4194,
  "star_groups": [
    "royal_stars"
  ],
  "timezone": {
    "iana_name": "America/Los_Angeles"
  }
}

Response

Successful Response

metadataobject required

natal_jd, design_jd, deep_fields (whether longitude/color/tone/base are included) and, when they are not, deep_fields_note.

Changes

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