Credit Score API reference

Request a signed credit-score credential and pull the detailed signal breakdown.

Credit Score API reference

Base URL:

https://api.fullness.finance/api/credit-api/v1

All requests require the x-api-key and x-signature headers described in Authentication & request signing.

POST /score

Resolves the DID via the identity registry, pulls the latest scoring-engine signals, and returns a W3C Verifiable Credential signed by the Fullness issuer DID.

curl -X POST https://api.fullness.finance/api/credit-api/v1/score \
  -H "content-type: application/json" \
  -H "x-api-key: ffpk_prod_XXXXXXXXXXXX.YYYYYYYYYYYYYYYYYYYYYY" \
  -H "x-signature: sha256=$SIG" \
  --data '{"did":"did:fullness:abcd1234","consent_token":"ct_opaque"}'

GET /health-signals/:did

Returns the detailed dimension breakdown (solvency, stability, responsibility, diversity) behind a score. Premium tier; billed at 10 units per call.

curl -H "x-api-key: $API_KEY" -H "x-signature: sha256=..." \
  https://api.fullness.finance/api/credit-api/v1/health-signals/did:fullness:abcd1234

Full spec

The canonical OpenAPI 3 definition lives at services/credit-api-service/openapi.yaml in the platform monorepo. Generate SDKs with openapi-generator-cli.