Zinnia

Zinnia Utility API

Utility operations

Documentation GitHub OpenAPI

Operations 3

GET /illustration/v3/version Get API version #

GET /illustration/v3/health Health Check #

POST /illustration/v3/utility/calculateAge Calculate age #

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/zinnia:zinnia-utility-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:
  version: 3.5.3
  title: Illustration Generation Utility API
  description: Create and manage illustration requests
servers:
- url: https://dev.api.zinnia.io
  description: Development
tags:
- name: Utility
  description: Utility operations
paths:
  /illustration/v3/version:
    get:
      operationId: get-version
      summary: Get API version
      description: Returns the current version of the illustration API
      responses:
        '200':
          description: Version information retrieved successfully
          content:
            application/json:
              schema:
                type: string
                description: The current API version
                example: 3.2.12
      tags:
      - Utility
  /illustration/v3/health:
    get:
      operationId: get-health
      summary: Health Check
      description: Returns 200
      responses:
        '200':
          description: Empty 200 to indicate API is healthy
      tags:
      - Utility
  /illustration/v3/utility/calculateAge:
    post:
      operationId: calculate-age
      summary: Calculate age
      description: Calculates age based on date of birth and as-of date using specified calculation method
      requestBody:
        description: Age calculation request containing date of birth, as-of date, and calculation method
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Age-Calculation-Request'
      responses:
        '200':
          description: Age calculation completed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Age-Calculation-Response'
        '400':
          description: The request was malformed
        '500':
          description: An unexpected processing error occurred
      security:
      - Auth0: []
      tags:
      - Utility
components:
  schemas:
    Age-Calculation-Method:
      type: string
      enum:
      - AGE_LAST
      - AGE_NEAREST
      description: Age calculation method - AGE_LAST for age at last birthday, AGE_NEAREST for age at nearest birthday
      example: AGE_LAST
    Age-Calculation-Request:
      type: object
      required:
      - dateOfBirth
      - asOfDate
      - calculationMethod
      properties:
        dateOfBirth:
          type: string
          format: date
          description: Date of birth in ISO-8601 format
          example: '1990-08-25'
        asOfDate:
          type: string
          format: date
          description: As-of date in ISO-8601 format
          example: '2025-08-25'
        calculationMethod:
          $ref: '#/components/schemas/Age-Calculation-Method'
    Age-Calculation-Response:
      type: object
      properties:
        age:
          type: integer
          description: Calculated age
          example: 35
        monthsSinceLastBirthday:
          type: integer
          description: Number of months since last birthday
          example: 0
  securitySchemes:
    Auth0:
      type: openIdConnect
      openIdConnectUrl: https://login.dev.zinnia.com/.well-known/openid-configuration
      x-kong-security-openid-connect:
        config:
          run_on_preflight: true
          scopes_claim:
          - https://dev.api.zinnia.io/permissions
          audience_claim:
          - aud
          audience_required:
          - https://dev.api.zinnia.io
          auth_methods:
          - bearer
          scopes: []
        enabled: true
        protocols:
        - grpc
        - grpcs
        - http
        - https
x-kong-service-defaults:
  connect_timeout: 120000
  read_timeout: 120000
  write_timeout: 120000