Astrology API

Astrology API Human Design API

The Human Design API from Astrology API — 5 operation(s) for human design.

Documentation GitHub OpenAPI

Operations 5

POST /human-design POST /v1/human-design #

POST /human-design/analysis POST /v1/human-design/analysis #

POST /human-design/chart-data POST /v1/human-design/chart-data #

POST /human-design/chart-interpretation POST /v1/human-design/chart-interpretation #

POST /human-design/traits-interpretation POST /v1/human-design/traits-interpretation #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/astrology-api-human-design-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AstrologyAPI JSON Human Design API
  version: 1.0.0
  description: Vedic (Jyotish), Western, Human Design and AstroCartoGraphy calculation endpoints served from the AstrologyAPI JSON host. Every operation is a POST that takes birth or location details and returns computed astrological data.
  contact:
    name: AstrologyAPI Support
    email: support@astrologyapi.com
    url: https://astrologyapi.com/contact
  termsOfService: https://astrologyapi.com/legal/terms-service
  license:
    name: Proprietary
    url: https://astrologyapi.com/legal/terms-service
servers:
- url: https://json.astrologyapi.com/v1
  description: AstrologyAPI JSON API production host
security:
- basicAuth: []
- accessToken: []
tags:
- name: Human Design
paths:
  /human-design:
    post:
      operationId: human_design
      summary: POST /v1/human-design
      tags:
      - Human Design
      description: Builds a person's core Human Design bodygraph from birth details.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                gender:
                  type: string
                day:
                  type: integer
                month:
                  type: integer
                year:
                  type: integer
                hour:
                  type: integer
                min:
                  type: integer
                lat:
                  type: number
                lon:
                  type: number
                tzone:
                  type: integer
              required:
              - name
              - gender
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
            example:
              name: Ajeet
              gender: male
              day: 15
              month: 8
              year: 1990
              hour: 10
              min: 30
              lat: 39.9526
              lon: -75.1652
              tzone: -5
      responses:
        '200':
          description: Computed result. The provider does not publish a response schema for this operation; see the endpoint reference for the returned fields.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication failed — missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: false
                msg: API authentication failed!
        '404':
          description: The requested API endpoint is not available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
              example:
                status: false
                statusCode: 404
                error_msg: The requested API endpoint is not available. Kindly check your api name/url or HTTP method type.
      externalDocs:
        description: Human Design documentation
        url: https://astrologyapi.com/products/human-design-api
      x-postman-collection: Human Design APIs Collection
  /human-design/analysis:
    post:
      operationId: human_design_analysis
      summary: POST /v1/human-design/analysis
      tags:
      - Human Design
      description: Summarizes a Human Design chart into concise analysis blocks.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                gender:
                  type: string
                day:
                  type: integer
                month:
                  type: integer
                year:
                  type: integer
                hour:
                  type: integer
                min:
                  type: integer
                lat:
                  type: number
                lon:
                  type: number
                tzone:
                  type: integer
              required:
              - name
              - gender
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
            example:
              name: Ajeet
              gender: male
              day: 15
              month: 8
              year: 1990
              hour: 10
              min: 30
              lat: 39.9526
              lon: -75.1652
              tzone: -5
      responses:
        '200':
          description: Computed result. The provider does not publish a response schema for this operation; see the endpoint reference for the returned fields.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication failed — missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: false
                msg: API authentication failed!
        '404':
          description: The requested API endpoint is not available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
              example:
                status: false
                statusCode: 404
                error_msg: The requested API endpoint is not available. Kindly check your api name/url or HTTP method type.
      externalDocs:
        description: Human Design documentation
        url: https://astrologyapi.com/products/human-design-api
      x-postman-collection: Human Design APIs Collection
  /human-design/chart-data:
    post:
      operationId: human_design_chart_data
      summary: POST /v1/human-design/chart-data
      tags:
      - Human Design
      description: Returns detailed Human Design chart payload including computed chart data.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                gender:
                  type: string
                day:
                  type: integer
                month:
                  type: integer
                year:
                  type: integer
                hour:
                  type: integer
                min:
                  type: integer
                lat:
                  type: number
                lon:
                  type: number
                tzone:
                  type: integer
              required:
              - name
              - gender
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
            example:
              name: Ajeet
              gender: male
              day: 15
              month: 8
              year: 1990
              hour: 10
              min: 30
              lat: 39.9526
              lon: -75.1652
              tzone: -5
      responses:
        '200':
          description: Computed result. The provider does not publish a response schema for this operation; see the endpoint reference for the returned fields.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication failed — missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: false
                msg: API authentication failed!
        '404':
          description: The requested API endpoint is not available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
              example:
                status: false
                statusCode: 404
                error_msg: The requested API endpoint is not available. Kindly check your api name/url or HTTP method type.
      externalDocs:
        description: Human Design documentation
        url: https://astrologyapi.com/products/human-design-api
      x-postman-collection: Human Design APIs Collection
  /human-design/chart-interpretation:
    post:
      operationId: human_design_chart_interpretation
      summary: POST /v1/human-design/chart-interpretation
      tags:
      - Human Design
      description: Returns an interpretation focused on chart-level Human Design insights.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                gender:
                  type: string
                day:
                  type: integer
                month:
                  type: integer
                year:
                  type: integer
                hour:
                  type: integer
                min:
                  type: integer
                lat:
                  type: number
                lon:
                  type: number
                tzone:
                  type: integer
              required:
              - name
              - gender
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
            example:
              name: Ajeet
              gender: male
              day: 15
              month: 8
              year: 1990
              hour: 10
              min: 30
              lat: 39.9526
              lon: -75.1652
              tzone: -5
      responses:
        '200':
          description: Computed result. The provider does not publish a response schema for this operation; see the endpoint reference for the returned fields.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication failed — missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: false
                msg: API authentication failed!
        '404':
          description: The requested API endpoint is not available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
              example:
                status: false
                statusCode: 404
                error_msg: The requested API endpoint is not available. Kindly check your api name/url or HTTP method type.
      externalDocs:
        description: Human Design documentation
        url: https://astrologyapi.com/products/human-design-api
      x-postman-collection: Human Design APIs Collection
  /human-design/traits-interpretation:
    post:
      operationId: human_design_traits_interpretation
      summary: POST /v1/human-design/traits-interpretation
      tags:
      - Human Design
      description: Returns trait-level interpretation for Human Design insights.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                gender:
                  type: string
                day:
                  type: integer
                month:
                  type: integer
                year:
                  type: integer
                hour:
                  type: integer
                min:
                  type: integer
                lat:
                  type: number
                lon:
                  type: number
                tzone:
                  type: integer
              required:
              - name
              - gender
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
            example:
              name: Ajeet
              gender: male
              day: 15
              month: 8
              year: 1990
              hour: 10
              min: 30
              lat: 39.9526
              lon: -75.1652
              tzone: -5
      responses:
        '200':
          description: Computed result. The provider does not publish a response schema for this operation; see the endpoint reference for the returned fields.
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Authentication failed — missing or invalid credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: false
                msg: API authentication failed!
        '404':
          description: The requested API endpoint is not available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
              example:
                status: false
                statusCode: 404
                error_msg: The requested API endpoint is not available. Kindly check your api name/url or HTTP method type.
      externalDocs:
        description: Human Design documentation
        url: https://astrologyapi.com/products/human-design-api
      x-postman-collection: Human Design APIs Collection
components:
  schemas:
    NotFound:
      type: object
      properties:
        status:
          type: boolean
        statusCode:
          type: integer
        error_msg:
          type: string
    Error:
      type: object
      properties:
        status:
          type: boolean
        msg:
          type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication. Username is your AstrologyAPI User ID, password is your API key. Used with form-encoded request bodies on subscription endpoints.
    accessToken:
      type: apiKey
      in: header
      name: x-astrologyapi-key
      description: Wallet Access Token sent in the x-astrologyapi-key header, used with JSON request bodies on wallet-billed and Chat endpoints.
externalDocs:
  description: AstrologyAPI developer hub
  url: https://astrologyapi.com/developers/v1
x-generated-from: postman-collection
x-generated-note: Derived operation-by-operation from the eight Postman collections AstrologyAPI publishes at https://astrologyapi.com/developers/v1/postman-collection. Paths, HTTP methods, request fields and example values are taken verbatim from those collections. The 401 and 404 response envelopes were observed on live unauthenticated requests to the host on 2026-09-07. The provider publishes no response schemas, so 200 bodies are typed only as objects rather than invented. This is an API Evangelist derivation, not a contract published by AstrologyAPI.
x-source-collections:
- https://astrologyapi.com/postman/ACG.postman_collection.json
- https://astrologyapi.com/postman/HD%20Collection.postman_collection.json
- https://astrologyapi.com/postman/face_reading_API_collection_postman_collection.json
- https://astrologyapi.com/postman/palm_API_collection_postman_collection.json
- https://astrologyapi.com/postman/vedic_astrology_API_collection_postman_collection.json
- https://astrologyapi.com/postman/vedic_astrology_pdf_API_collection_postman_collection.json
- https://astrologyapi.com/postman/western_astrology_API_collection_postman_collection.json
- https://astrologyapi.com/postman/western_astrology_pdf_API_collection_postman_collection.json