> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fraudintelligencelimited.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Service and per-upstream-source availability



## OpenAPI

````yaml https://2npugbuiw5.execute-api.eu-central-1.amazonaws.com/v1/openapi.yaml get /v1/health
openapi: 3.1.0
info:
  title: FIL Fraud Scoring API
  version: 1.0.2
  description: >
    Tiered fraud risk scoring for phone numbers and IP addresses. Scores are
    rankings relative to the scored population, never probabilities.
servers: []
security:
  - bearerAuth: []
paths:
  /v1/health:
    get:
      summary: Service and per-upstream-source availability
      operationId: health
      responses:
        '200':
          description: Health report
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Health'
      security: []
components:
  schemas:
    Health:
      type: object
      description: >-
        Service health, reported per scoring CAPABILITY — the same names that
        appear as components in scoring responses, in degraded_sources, and in
        the tier matrix. "degraded" means scoring continues on reduced evidence
        for that capability (affected responses mark it in degraded_sources) —
        never an outage by itself. A top-level status of "degraded" with all
        capabilities "ok" indicates a platform issue under investigation; if the
        system of record is unreachable no scores are issued at all, since a
        score that cannot be audited is never returned.
      properties:
        status:
          type: string
          enum:
            - ok
            - degraded
        capabilities:
          type: object
          description: >-
            Availability of each live scoring capability. "identity_resolution",
            "caller_id_integrity", "ndc_range_risk" and "premium_tariff" draw on
            FIL's numbering-plan intelligence (ITU allocations, operator
            attribution, range-level risk scores derived from consortium
            reporting). "reputation_ledger" and "ip_reputation" draw on the
            consortium's reported-identifier ledger. Derived capabilities
            (corroboration) degrade with their inputs and are not listed
            separately. Capabilities admitted per commercial tier are defined in
            the entitlements matrix; this endpoint lists every live capability
            regardless of tier.
          additionalProperties:
            type: string
            enum:
              - ok
              - degraded

````