Notable updates to the Gooclaim API and partner-facing docs

May 20, 2026

Initial release

The Gooclaim v1.0 API reference is now live at api.docs.gooclaim.com.

What’s documented

  • Auth Service — JWT issuance via POST /v1/auth/token, token introspection, and the Authorization: Bearer pattern used on every other endpoint.
  • Workflow Engine — three workflows for the v1.0 pilot: Claim Status, Pending Documents, and Query Reason.
  • Audit Ledger — tenant-scoped read API for retrieving immutable audit events.
  • Webhooks — AsyncAPI schemas for outbound events partners can subscribe to.

Conventions

  • All business endpoints are mounted under /v1/*. Health, readiness, metrics, and OpenAPI live at root.
  • PHI fields (claim IDs, phone numbers, names) are SHA-256 hashed in any returned payload. Plaintext correlation stays in your system.
  • Errors follow RFC 7807 problem-detail JSON with a stable error_code.
  • Mutating endpoints accept an Idempotency-Key header.