naftiko: 1.0.0-alpha2
info:
  label: Tink Data Enrichment
  description: Categorise transactions, identify merchants, and detect or predict recurring transactions via Tink Data Enrichment.
  tags:
    - Tink
    - Data Enrichment
    - Categorisation
    - Recurring Transactions
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      TINK_BEARER_TOKEN: TINK_BEARER_TOKEN
capability:
  consumes:
    - type: http
      namespace: enrichment
      baseUri: https://api.tink.com
      description: Tink Data Enrichment business capability.
      resources:
        - name: enriched-transactions
          path: /enrichment/v1/transactions
          operations:
            - name: list
              method: GET
              description: List enriched transactions.
              outputRawFormat: json
        - name: categories
          path: /enrichment/v1/categories
          operations:
            - name: list
              method: GET
              description: List Tink categorisation taxonomy.
              outputRawFormat: json
              inputParameters:
                - name: locale
                  in: query
                  type: string
        - name: recurring-transactions
          path: /enrichment/v1/recurring-transactions
          operations:
            - name: list
              method: GET
              description: List confirmed recurring transactions.
              outputRawFormat: json
        - name: predicted-recurring-transactions
          path: /enrichment/v1/predicted-recurring-transactions
          operations:
            - name: list
              method: GET
              description: List predicted recurring transactions.
              outputRawFormat: json
      authentication:
        type: bearer
        value: '{{env.TINK_BEARER_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: enrichment-rest
      port: 8080
      description: REST adapter for Tink Data Enrichment.
      resources:
        - path: /v1/enrichment/transactions
          name: enriched-transactions
          operations:
            - method: GET
              name: list
              call: enrichment.list