> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humandesignapi.nl/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate a simplified bodygraph

> Generates a simplified Human Design chart with type, profile, gates, channels, and centers.



## OpenAPI

````yaml /openapi/v1-routes.yaml post /bodygraphs/simple
openapi: 3.0.3
info:
  title: Human Design API — v1
  description: |
    v1 endpoints for calculating and analyzing Human Design charts.

    ## Authentication
    All endpoints require two headers:
    - `HD-Api-Key` — your API key
    - `HD-Geocode-Key` — your Google Geocoding API key
  version: 1.1.204
  contact:
    name: API Support
    email: info@mail.humandesignapi.nl
    url: https://humandesignapi.nl
  license:
    name: Proprietary
    url: https://humandesignapi.nl
servers:
  - url: https://api.humandesignapi.nl/v1
    description: Production server
security: []
paths:
  /bodygraphs/simple:
    post:
      tags:
        - Bodygraph
      summary: Generate a simplified bodygraph
      description: >-
        Generates a simplified Human Design chart with type, profile, gates,
        channels, and centers.
      operationId: generateSimpleBodygraph
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BodygraphInput'
      responses:
        '200':
          description: Successful simplified bodygraph generation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleBodygraphResponse'
        '400':
          description: Invalid input — birthdate, birthtime, or location is malformed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '401':
          description: >-
            Authentication failed — API key missing, invalid, or geocode key
            missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '403':
          description: Access denied — user does not have access to this feature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
      security:
        - ApiKeyAuth: []
          GeocodeKeyAuth: []
components:
  schemas:
    BodygraphInput:
      type: object
      required:
        - birthdate
        - birthtime
        - location
      properties:
        birthdate:
          type: string
          description: Date of birth in a valid format
          example: 01-Jan-1990
        birthtime:
          type: string
          description: Time of birth in HH:MM format
          example: '14:30'
        location:
          type: string
          minLength: 4
          description: Location of birth (city, country)
          example: Haarlem, The Netherlands
    SimpleBodygraphResponse:
      type: object
      properties:
        type:
          type: string
          description: >-
            Human Design type: Generator, Manifesting Generator, Projector,
            Manifestor, or Reflector
          example: Generator
        profile:
          type: string
          description: Profile line combination
          example: 6/2
        gates:
          type: array
          items:
            type: string
          description: All activated gate numbers
          example:
            - '20'
            - '34'
            - '10'
            - '57'
        channels_short:
          type: array
          items:
            type: string
          description: Active channel connections as gate pairs
          example:
            - 20-34
            - 10-57
        centers:
          type: array
          items:
            type: string
          description: Defined (active) energy centers
          example:
            - G
            - Sacral
            - Spleen
            - Throat
    StandardErrorResponse:
      type: object
      description: Standard error response envelope
      properties:
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp
        success:
          type: boolean
          example: false
        message:
          type: string
          description: Human-readable error description
        errorCode:
          type: string
          description: Machine-readable error code
        type:
          type: string
          example: ''
        data:
          type: object
          nullable: true
          example: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: HD-Api-Key
      description: Human Design API key
    GeocodeKeyAuth:
      type: apiKey
      in: header
      name: HD-Geocode-Key
      description: Google Geocoding API key

````