API & Developers

API showcase

Every DermaGenome intelligence service is available as a secure REST API. Explore requests, responses, authentication, rate limits, supported languages, and SDK examples. GraphQL is planned for a future release.

Request Developer Access Product Upload

Request

curl -X POST https://api.dermagenome.comPOST /v1/analysis/request \
  -H "Authorization: Bearer $DERMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "client_id": "C-204" }'

Response

{
  "analysis_id": "DG-A-7F3A92",
  "status": "completed",
  "confidence": 0.92,
  "biomarkers": [
    { "key": "fine_lines", "severity": "mild", "score": 0.34, "confidence": 0.89 },
    { "key": "hydration", "severity": "moderate", "score": 0.58, "confidence": 0.91 },
    { "key": "pigmentation", "severity": "mild", "score": 0.21, "confidence": 0.85 }
  ],
  "priorities": [
    { "key": "hydration", "rank": 1 },
    { "key": "fine_lines", "rank": 2 }
  ]
}

Authentication

// JavaScript SDK
import { DermaGenome } from '@dermagenome/sdk';
const dg = new DermaGenome({ apiKey: process.env.DERMA_API_KEY });
const result = await dg.analysis.request({ clientId: 'C-204' });

Authentication

Bearer token via DERMA_API_KEY. Keys are issued per application and scoped per service.

Rate limits

Standard: 100 requests/minute. Enterprise: custom quotas. Burst tokens refill continuously.

Supported languages & SDKs

JavaScriptPythonSwiftKotlinREST

Protocol

REST (stable). GraphQL is planned for a future release.