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/geniusdecision-app:geniusdecision-app-choice-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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: Genius Decision — agent integration Choice API
  version: 0.2.0
  description: 'Genius bounded beta: HTTP agent integration subset. Public discovery; no-human-registration synthetic demo; automatic machine registration for synthetic/non-personal data; separate existing human-account keys. Machine Bearer keys are scoped, revocable and expire after 7 days (demo: 1 hour). Rotation only retains/reduces scopes. Human keys retain full account permissions. No MCP or OAuth. HTTP acceptance is distinct from formal admission and empirical evidence. Body limit 128 KiB; input limit 110000 JSON bytes. Declared choice profile: /static/decisions.html; explicit review and confirmation required. No general narrative solver or real-world CAG/PVS claim.'
servers:
- url: /
security:
- AccountBearer: []
tags:
- name: Choice
paths:
  /api/choice/review:
    post:
      operationId: prepareDecision
      summary: Review explicit low-risk decision model before confirming and saving it.
      security:
      - AccountBearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChoiceModel'
      responses:
        '200':
          description: Model, confirmation digest, missing-data questions and scope. No case is created.
        '400':
          description: Invalid model or unsupported category.
        '401':
          description: Authentication required.
        '403':
          description: Requires cases:write for agents; humans require session and CSRF.
      tags:
      - Choice
components:
  schemas:
    ChoiceModel:
      type: object
      properties:
        context:
          type: object
          properties:
            question:
              type: string
              minLength: 1
              maxLength: 600
            category:
              enum:
              - leisure
              - personal_organization
            horizon:
              type: string
              minLength: 1
              maxLength: 100
          required:
          - question
          - category
          - horizon
          additionalProperties: false
        criteria:
          type: array
          minItems: 1
          maxItems: 5
          items:
            type: object
            properties:
              id:
                type: string
                pattern: ^[A-Za-z][A-Za-z0-9_]{0,31}$
              label:
                type: string
                minLength: 1
                maxLength: 60
              unit:
                type: string
                minLength: 1
                maxLength: 30
              direction:
                enum:
                - min
                - max
              limit:
                type:
                - string
                - 'null'
                pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]+|/[1-9][0-9]*)?$
                maxLength: 32
                description: Nonnegative exact quantity <= 1000000, denominator <= 1000000; null stays unknown.
            required:
            - id
            - label
            - unit
            - direction
            - limit
            additionalProperties: false
        alternatives:
          type: array
          minItems: 2
          maxItems: 8
          items:
            type: object
            properties:
              id:
                type: string
                pattern: ^[A-Za-z][A-Za-z0-9_]{0,31}$
              label:
                type: string
                minLength: 1
                maxLength: 80
              source:
                type: string
                minLength: 1
                maxLength: 200
              values:
                type: object
                additionalProperties:
                  type:
                  - string
                  - 'null'
                  pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]+|/[1-9][0-9]*)?$
                  maxLength: 32
                  description: Nonnegative exact quantity <= 1000000, denominator <= 1000000; null stays unknown.
                description: Exactly one entry per declared criterion ID; same unit for every alternative.
            required:
            - id
            - label
            - source
            - values
            additionalProperties: false
        selection:
          type: object
          properties:
            mode:
              enum:
              - unique
              - lexicographic
            criteria_order:
              type: array
              items:
                type: string
                pattern: ^[A-Za-z][A-Za-z0-9_]{0,31}$
              maxItems: 5
              uniqueItems: true
              description: Empty for unique; permutation of all criteria for lexicographic.
          required:
          - mode
          - criteria_order
          additionalProperties: false
      required:
      - context
      - criteria
      - alternatives
      - selection
      additionalProperties: false
  securitySchemes:
    AccountBearer:
      type: http
      scheme: bearer
      description: HTTPS Authorization Bearer only. ga_ machine credentials carry enforced scopes and expiry for their own isolated space. gb_ human-account API keys retain full-account access. Neither is a JWT. No key in a query string.
externalDocs:
  description: Full API contract and limitations
  url: https://geniusdecision.app/static/api.html
x-genius-mcp-available: true
x-genius-credential-scope:
  human: full-account
  automatic_agent: enforced-scopes-and-expiry
x-genius-client-safety:
  human_consent_never_inferred: true
  automatic_agent_data_policy: synthetic_or_non_personal_only
  synthetic_examples_are_not_empirical_evidence: true
  no_automatic_write_retries: true
x-genius-mcp:
  url: /mcp
  transport: streamable-http
  protocol_versions:
  - '2026-07-28'
  - '2025-11-25'
  - '2025-06-18'
  - '2025-03-26'
  public_tools:
  - get_capabilities
  - read_demo_result
  - run_demo
  private_authentication: scoped-machine-bearer-header
  oauth: false
x-genius-saved-demo:
  json: /static/demo-result.json
  html: /static/demo.html
  live_execution_on_get: false
  evidence_origin: synthetic