Astrology API

AstrologyAPI PDF Reports API

White-labeled PDF report generation for Vedic and Western astrology — mini, basic and professional Kundli, matchmaking, gemstone, Varshaphal, pro numerology, natal, solar return, life forecast, synastry and star sign compatibility reports. Each operation returns a hosted pdf_url and accepts eleven per-request branding fields (logo, domain, footer link and company contact details). Reports are billed per generation from the credit wallet, from INR 1.50 to INR 100 depending on the report.

GitHub OpenAPI

Operations 12

POST /basic_gemstone_report_pdf Gemstone Report PDF #
POST /basic_horoscope_pdf Basic PDF #
POST /life_forecast_report/tropical Life Forecast Report PDF #
POST /match_making_pdf Match Making PDF #
POST /mini_horoscope_pdf Mini Kundli PDF #
POST /natal_horoscope_report/tropical Natal Chart PDF Report #
POST /pro_horoscope_pdf Professional PDF #
POST /pro_numerology_report Pro Numerology Report PDF #
POST /solar_return_report/tropical Solar Return PDF Report #
POST /star_sign_compatibility_report Star Sign Compatibility Report PDF #
POST /synastry_couple_report/tropical Synastry PDF Report #
POST /varshphal_horoscope_pdf Varshaphal Horoscope PDF #

Documentation

📖
Documentation
https://astrologyapi.com/developers/v1/pdf

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/astrology-api/refs/heads/main/openapi/astrology-api-pdf-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/astrology-api/refs/heads/main/overlays/astrology-api-pdf-overlay.yaml
🔗
Postman
https://astrologyapi.com/developers/v1/postman-collection

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-pdf"
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

astrology-api-pdf-openapi.yml Raw ↑ 
# generated: '2026-09-07'
# method: derived
# source: https://astrologyapi.com/developers/v1/postman-collection (8 first-party Postman collections)
openapi: 3.1.0
info:
  title: AstrologyAPI PDF Reports API
  version: 1.0.0
  description: White-labeled PDF report generation for Vedic and Western astrology. Each operation returns
    a hosted download URL (pdf_url) for the generated report.
  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
externalDocs:
  description: AstrologyAPI developer hub
  url: https://astrologyapi.com/developers/v1
servers:
- url: https://pdf.astrologyapi.com/v1
  description: AstrologyAPI PDF Reports API production host
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
tags:
- name: PDF Reports
security:
- basicAuth: []
- accessToken: []
paths:
  /basic_gemstone_report_pdf:
    post:
      operationId: basic_gemstone_report_pdf
      summary: Gemstone Report PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                min:
                  type: string
                lat:
                  type: string
                lon:
                  type: string
                tzone:
                  type: string
                gender:
                  type: string
                language:
                  type: string
                place:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
              - gender
              - language
              - place
              - chart_style
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
            example:
              name: Ajeet
              day: '19'
              month: '1'
              year: '2001'
              hour: '11'
              min: '40'
              lat: '19.31'
              lon: '72.86'
              tzone: '5.5'
              gender: male
              language: en
              place: Mumbai, Maharashtra, India
              chart_style: NORTH_INDIAN
              footer_link: 'https:'
              company_name: astrologyapi
              company_info: company info
              domain_url: 'https:'
              company_landline: '123456789'
              company_mobile: '123456789'
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Indian Astrology PDF API collection (User Collection)
  /basic_horoscope_pdf:
    post:
      operationId: basic_horoscope_pdf
      summary: Basic PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                min:
                  type: string
                lat:
                  type: string
                lon:
                  type: string
                tzone:
                  type: string
                gender:
                  type: string
                language:
                  type: string
                place:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
              - gender
              - language
              - place
              - chart_style
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
            example:
              name: Ajeet
              day: '9'
              month: '1'
              year: '2001'
              hour: '11'
              min: '40'
              lat: '19.31'
              lon: '72.86'
              tzone: '5.5'
              gender: male
              language: en
              place: Mumbai, Maharashtra, India
              chart_style: NORTH_INDIAN
              footer_link: 'https:'
              company_name: rnb
              company_info: company info
              domain_url: 'https:'
              company_landline: '123456789'
              company_mobile: '123456789'
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Indian Astrology PDF API collection (User Collection)
  /life_forecast_report/tropical:
    post:
      operationId: life_forecast_report_tropical
      summary: Life Forecast Report PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                minute:
                  type: string
                latitude:
                  type: string
                longitude:
                  type: string
                timezone:
                  type: string
                place:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
                language:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - minute
              - latitude
              - longitude
              - timezone
              - place
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
              - language
            example:
              name: Linda Ray
              day: '6'
              month: '10'
              year: '2001'
              hour: '7'
              minute: '45'
              latitude: '19.20'
              longitude: '25.20'
              timezone: '5.5'
              place: Mumbai, Maharashtra, India
              footer_link: astrologyapi.com
              company_name: astrologyapi
              company_info: this is astrologyapi
              domain_url: astrologyapi.com
              company_email: mail@astrologyapi.com
              company_landline: +91- 221232 22
              company_mobile: +91 1212 1212 12
              language: en
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Western Astrology PDF API (User Collection)
  /match_making_pdf:
    post:
      operationId: match_making_pdf
      summary: Match Making PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                m_first_name:
                  type: string
                m_last_name:
                  type: string
                m_day:
                  type: string
                m_month:
                  type: string
                m_year:
                  type: string
                m_hour:
                  type: string
                m_minute:
                  type: string
                m_latitude:
                  type: string
                m_longitude:
                  type: string
                m_timezone:
                  type: string
                m_place:
                  type: string
                f_first_name:
                  type: string
                f_last_name:
                  type: string
                f_day:
                  type: string
                f_month:
                  type: string
                f_year:
                  type: string
                f_hour:
                  type: string
                f_minute:
                  type: string
                f_latitude:
                  type: string
                f_longitude:
                  type: string
                f_timezone:
                  type: string
                f_place:
                  type: string
                language:
                  type: string
                ashtakoot:
                  type: string
                papasyam:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                domain_url:
                  type: string
                logo_url:
                  type: string
                dashakoot:
                  type: string
              required:
              - m_first_name
              - m_last_name
              - m_day
              - m_month
              - m_year
              - m_hour
              - m_minute
              - m_latitude
              - m_longitude
              - m_timezone
              - m_place
              - f_first_name
              - f_last_name
              - f_day
              - f_month
              - f_year
              - f_hour
              - f_minute
              - f_latitude
              - f_longitude
              - f_timezone
              - f_place
              - language
              - ashtakoot
              - papasyam
              - chart_style
              - footer_link
              - domain_url
              - logo_url
              - dashakoot
            example:
              m_first_name: adarsh
              m_last_name: sharma
              m_day: '1'
              m_month: '5'
              m_year: '2000'
              m_hour: '7'
              m_minute: '10'
              m_latitude: '19.23'
              m_longitude: '72.42'
              m_timezone: '5.5'
              m_place: Mumbai, Maharashtra, India
              f_first_name: sneha
              f_last_name: gupta
              f_day: '23'
              f_month: '4'
              f_year: '2000'
              f_hour: '21'
              f_minute: '12'
              f_latitude: '19.23'
              f_longitude: '72.42'
              f_timezone: '5.5'
              f_place: Mumbai, Mahrashtra, India
              language: en
              ashtakoot: 'true'
              papasyam: 'true'
              chart_style: SOUTH_INDIAN
              footer_link: astrologyapi.com
              domain_url: https://www.astrologyapi.com
              dashakoot: 'true'
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Indian Astrology PDF API collection (User Collection)
  /mini_horoscope_pdf:
    post:
      operationId: mini_horoscope_pdf
      summary: Mini Kundli PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                min:
                  type: string
                lat:
                  type: string
                lon:
                  type: string
                tzone:
                  type: string
                gender:
                  type: string
                language:
                  type: string
                place:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
              - gender
              - language
              - place
              - chart_style
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
            example:
              name: Ajeet
              day: '9'
              month: '1'
              year: '2001'
              hour: '11'
              min: '40'
              lat: '19.31'
              lon: '72.86'
              tzone: '5.5'
              gender: male
              language: en
              place: Mumbai, Maharashtra, India
              chart_style: NORTH_INDIAN
              footer_link: 'https:'
              company_name: rnb
              company_info: company info
              domain_url: 'https:'
              company_landline: '123456789'
              company_mobile: '123456789'
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Indian Astrology PDF API collection (User Collection)
  /natal_horoscope_report/tropical:
    post:
      operationId: natal_horoscope_report_tropical
      summary: Natal Chart PDF Report
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                minute:
                  type: string
                latitude:
                  type: string
                longitude:
                  type: string
                timezone:
                  type: string
                place:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
                language:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - minute
              - latitude
              - longitude
              - timezone
              - place
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
              - language
            example:
              name: Linda Ray
              day: '6'
              month: '10'
              year: '2001'
              hour: '7'
              minute: '45'
              latitude: '19.20'
              longitude: '25.20'
              timezone: '5.5'
              place: Mumbai, Maharashtra, India
              footer_link: astrologyapi.com
              company_name: astrologyapi
              company_info: this is astrologyapi
              domain_url: astrologyapi.com
              company_email: mail@astrologyapi.com
              company_landline: +91- 221232 22
              company_mobile: +91 1212 1212 12
              language: en
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Western Astrology PDF API (User Collection)
  /pro_horoscope_pdf:
    post:
      operationId: pro_horoscope_pdf
      summary: Professional PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                min:
                  type: string
                lat:
                  type: string
                lon:
                  type: string
                tzone:
                  type: string
                gender:
                  type: string
                language:
                  type: string
                place:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
              required:
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
              - gender
              - language
              - place
              - chart_style
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
            example:
              day: '9'
              month: '1'
              year: '2001'
              hour: '11'
              min: '40'
              lat: '19.31'
              lon: '72.86'
              tzone: '5.5'
              gender: male
              language: en
              place: Mumbai, Maharashtra, India
              chart_style: NORTH_INDIAN
              footer_link: 'https:'
              company_name: rnb
              company_info: company info
              domain_url: 'https:'
              company_landline: '123456789'
              company_mobile: '123456789'
      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: PDF Reports documentation
        url: https://astrologyapi.com/developers/v1/pdf
      x-postman-collection: Indian Astrology PDF API collection (User Collection)
  /pro_numerology_report:
    post:
      operationId: pro_numerology_report
      summary: Pro Numerology Report PDF
      tags:
      - PDF Reports
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                day:
                  type: string
                month:
                  type: string
                year:
                  type: string
                hour:
                  type: string
                min:
                  type: string
                lat:
                  type: string
                lon:
                  type: string
                tzone:
                  type: string
                gender:
                  type: string
                language:
                  type: string
                place:
                  type: string
                chart_style:
                  type: string
                footer_link:
                  type: string
                logo_url:
                  type: string
                company_name:
                  type: string
                company_info:
                  type: string
                domain_url:
                  type: string
                company_email:
                  type: string
                company_landline:
                  type: string
                company_mobile:
                  type: string
              required:
              - name
              - day
              - month
              - year
              - hour
              - min
              - lat
              - lon
              - tzone
              - gender
              - language
              - place
              - chart_style
              - footer_link
              - logo_url
              - company_name
              - company_info
              - domain_url
              - company_email
              - company_landline
              - company_mobile
   

# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/astrology-api/refs/heads/main/openapi/astrology-api-pdf-openapi.yml