naftiko: 1.0.0-alpha2
info:
  label: Tink Risk and Reports
  description: Retrieve Tink Income Check, Expense Check, Risk Insights, and Risk Categorisation reports for affordability and lending decisions.
  tags:
    - Tink
    - Open Banking
    - Risk
    - Income Verification
    - Lending
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      TINK_BEARER_TOKEN: TINK_BEARER_TOKEN
capability:
  consumes:
    - type: http
      namespace: risk-reports
      baseUri: https://api.tink.com
      description: Tink Risk and Reports business capability.
      resources:
        - name: income-check
          path: /v2/income-checks/{report_id}
          operations:
            - name: get
              method: GET
              description: Get Income Check report as JSON.
              outputRawFormat: json
              inputParameters:
                - name: report_id
                  in: path
                  type: string
                  required: true
        - name: expense-check
          path: /risk/v1/expense-checks/{report_id}
          operations:
            - name: get
              method: GET
              description: Get Expense Check report as JSON.
              outputRawFormat: json
              inputParameters:
                - name: report_id
                  in: path
                  type: string
                  required: true
        - name: risk-insights
          path: /risk/v1/risk-insights/{report_id}
          operations:
            - name: get
              method: GET
              description: Get Risk Insights report.
              outputRawFormat: json
              inputParameters:
                - name: report_id
                  in: path
                  type: string
                  required: true
        - name: risk-categorisation
          path: /risk/v2/risk-categorisation/reports/{report_id}
          operations:
            - name: get
              method: GET
              description: Get Risk Categorisation report.
              outputRawFormat: json
              inputParameters:
                - name: report_id
                  in: path
                  type: string
                  required: true
      authentication:
        type: bearer
        value: '{{env.TINK_BEARER_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: risk-reports-rest
      port: 8080
      description: REST adapter for Tink Risk and Reports.
      resources:
        - path: /v1/risk/income-check/{report_id}
          name: income-check
          operations:
            - method: GET
              name: get
              call: risk-reports.get
              with:
                report_id: rest.path.report_id