Getting Started

Web interface

Visit the BiomAPI web app and upload a biometry PDF or image. No account required — just drop a file and get structured measurements instantly.

Upload tab — single file, automatic engine selection
Batch tab — up to many files processed concurrently
BiomPIN tab — retrieve a previously shared result
Transcribe tab — manual data entry (BiomDIRECT)
History tab — previously retrieved BiomPINs (stored locally)

REST API

Process a file

curl -X POST https://biomapi.com/api/v1/biom/process \
  -F "file=@report.pdf"

Response:

{
  "data": {
    "biometer": { "device_name": "IOLMaster700", "manufacturer": "Zeiss" },
    "patient": { "name": "JD", "id": "12345", "date_of_birth": "1965-03-15", "gender": "Male" },
    "right_eye": { "AL": 23.45, "ACD": 3.12, "K1_magnitude": 43.25, "K1_axis": 5,
                   "K2_magnitude": 44.50, "K2_axis": 95, "WTW": 11.8, "LT": 4.52,
                   "CCT": 545, "lens_status": "Phakic", "post_refractive": "None",
                   "keratometric_index": 1.3375 },
    "left_eye": { "..." : "..." }
  },
  "extra_data": null,
  "metadata": {
    "request_id": "3f5e3c51-d0b9-45fd-a7f4-6d7a3b592f42",
    "schema_version": "1.0.0",
    "app_version": "2.0.29",
    "extraction": {
      "method": "BiomAI",
      "timestamp": "2025-01-15T10:30:00Z",
      "byok": false,
      "llm": "gemini-3.5-flash",
      "input_schema_version": null
    }
  },
  "biompin": {
    "pin": "lunar-rocket-731904",
    "expires_at": "2025-02-15T10:30:00Z",
    "db_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

See Response Schema for the complete field reference.

Retrieve by BiomPIN

curl "https://biomapi.com/api/v1/biom/retrieve?biom_pin=lunar-rocket-731904"

Check API status

curl https://biomapi.com/api/v1/status

For active Gemini and database health checks, use:

curl https://biomapi.com/api/v1/health

CLI

Install the zero-dependency CLI and process files from the terminal:

python biomapi.py process report.pdf

See the CLI guide for installation and full usage.

Authentication

All endpoints work without an API key (with lower rate limits). For production integrations, pass your BiomAPI key to get higher limits:

curl -X POST https://biomapi.com/api/v1/biom/process \
  -H "Authorization: Bearer biom_your_key_here" \
  -F "file=@report.pdf"

See Authentication for details.

BYOK (Bring Your Own Gemini Key)

Use your own Google Gemini API key for a request-level BYOK extraction:

curl -X POST https://biomapi.com/api/v1/biom/process \
  -H "X-Gemini-API-Key: AIza_your_key" \
  -F "file=@report.pdf"

BYOK uses the biomai_byok bucket and overrides deployment-managed routing for that request. If the supplied Gemini key fails, the request fails rather than falling back to a server-managed credential.