Documentation

Integrate SkinGenius in minutes

A clean REST API to add skin-analysis to your clinical, telehealth, or research application. Below is a quick overview to get you started.

Getting started

Access to the API is granted through our early-access program. Once approved, you'll receive a sandbox key to build and test against before going live. Request access at contact@skingenius.app.

Authentication

All requests are authenticated with a bearer token sent in the Authorization header over HTTPS. Never expose your secret key in client-side code.

Authorization: Bearer sk_live_your_api_key

Quickstart

Submit an image for analysis:

curl https://api.skingenius.app/v1/analyze \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -F "image=@lesion.jpg"

Example response:

{
  "id": "an_8f2c1a",
  "risk": "low",
  "confidence": 0.992,
  "predictions": [
    { "label": "benign_nevus", "score": 0.92 },
    { "label": "seborrheic_keratosis", "score": 0.05 }
  ],
  "overlay_url": "https://api.skingenius.app/v1/overlay/an_8f2c1a"
}

Endpoints

POST /v1/analyze — submit an image and receive an assessment.
GET /v1/analyses/:id — retrieve a previous analysis.
GET /v1/overlay/:id — fetch the saliency overlay image.
POST /v1/webhooks — register endpoints for async events.

SDKs

Official client libraries are available for JavaScript/TypeScript and Python, with a FHIR-compatible layer for EHR integrations. Mobile (iOS/Android) SDKs are in early access.

Support

Questions or integration help? Email contact@skingenius.app and our team will get back to you.

Note: endpoints shown are illustrative of the platform and may change before general availability.