ivive.app Reference Compounds API

openapi: 3.2.0
info:
  title: ivive.app Reference Compounds API
  description: 'Calculations for early drug discovery: IVIVE hepatic clearance with its observed-CL band,

    structure-based predictions, species scaling.


    **No key needed** for single-compound endpoints, up to 120/minute per address.

    Batches need a login; a free account takes up to 25 compounds. For a key or more volume, write to

    hello@ivive.app.


    Results are research estimates, not for clinical, regulatory or dosing decisions. Structures and

    inputs are processed in memory and not stored. The same calculations are available to LLMs as an

    MCP server at `/mcp/`.


    Reference drugs and published animal PK come from public datasets, ChEMBL among them, under

    CC BY-SA 3.0 and other open licences: https://ivive.app/sources.'
  version: 1.0.0
servers:
- url: https://api.ivive.app
  description: Production
- url: /
  description: This server
tags:
- name: reference-compounds
paths:
  /api/reference-compounds:
    get:
      tags:
      - reference-compounds
      summary: Get Reference Compounds
      description: 'Get all reference compounds with validated literature values.


        Returns 4 reference compounds (Midazolam, Warfarin, Verapamil, Diltiazem)

        with experimentally measured clint, fu_mic, and fu_p values from Obach 1999.


        This is a public endpoint - no authentication required.'
      operationId: get_reference_compounds_api_reference_compounds_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ReferenceCompoundResponse'
                type: array
                title: Response Get Reference Compounds Api Reference Compounds Get
components:
  schemas:
    ReferenceCompoundResponse:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        smiles:
          type: string
          title: Smiles
        clint:
          type: number
          title: Clint
        fu_mic:
          type: number
          title: Fu Mic
        fu_p:
          type: number
          title: Fu P
        rb:
          anyOf:
          - type: number
          - type: 'null'
          title: Rb
        species:
          type: string
          title: Species
        source:
          type: string
          title: Source
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        cl_rat:
          anyOf:
          - type: number
          - type: 'null'
          title: Cl Rat
        cl_dog:
          anyOf:
          - type: number
          - type: 'null'
          title: Cl Dog
        cl_monkey:
          anyOf:
          - type: number
          - type: 'null'
          title: Cl Monkey
        fu_p_rat:
          anyOf:
          - type: number
          - type: 'null'
          title: Fu P Rat
        cl_human_obs:
          anyOf:
          - type: number
          - type: 'null'
          title: Cl Human Obs
        animal_source:
          anyOf:
          - type: string
          - type: 'null'
          title: Animal Source
      type: object
      required:
      - id
      - name
      - smiles
      - clint
      - fu_mic
      - fu_p
      - rb
      - species
      - source
      - description
      title: ReferenceCompoundResponse
      description: Response schema for reference compound data.
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /api/auth/login