Skip to main content

Phase 18 GENOMICS-09/10/11 — GET /api/v1/finngen/endpoints/{name}/profile?source_key={key}.

GET 
/api/v1/finngen/endpoints/:name/profile

Returns one of 3 envelope shapes per 18-UI-SPEC.md:

  • status=cached: full summary + km_points + comorbidities + drug_classes + meta
  • status=needs_compute: reason + dispatch_url (frontend auto-dispatches per D-10)
  • status=ineligible: error_code + message

Permission enforced at route level: finngen.endpoint_profile.view. Input shape enforced by ReadEndpointProfileRequest (Warning 4 hardening — no inline preg_match on source_key in the controller).

Partial-provisioning fallback (Warning 3): if the schema exists but a sibling table is missing (SQLSTATE 42P01 = undefined_table), returns status=needs_compute with reason=partial_provision so the frontend auto-dispatches a fresh compute instead of surfacing a 500.

Request​

Responses​