Fintecture

Fintecture Resources API

Catalog of supported banks (Providers) with per-bank AIS capabilities (accountholders, accounts, transactions) and PIS rails (SEPA, iSCT instant, FPS, PLN, INT). Also exposes sandbox test accounts for each bank.

Fintecture Resources API is one of 8 APIs that Fintecture publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 machine-runnable capabilities that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Banks, Providers, Reference Data, and Sandbox. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 2 Naftiko capability specs.

Documentation GitHub OpenAPI

OpenAPI Specification

openapi: 3.1.0
info:
  title: Fintecture Resources API
  description: >
    Reference data. Lists the supported bank providers with their AIS
    capabilities (accountholders, accounts, transactions) and PIS rails (SEPA,
    iSCT, FPS, PLN, INT), plus sandbox test accounts available per bank.
  version: "v1"
  contact:
    name: Fintecture Support
    url: https://fintecture.com/contact

servers:
  - url: https://api.fintecture.com
    description: Production
  - url: https://api-sandbox.fintecture.com
    description: Sandbox

security:
  - BearerAuth: []

tags:
  - name: Providers
    description: Bank providers / coverage
  - name: Test Accounts
    description: Sandbox test accounts

paths:
  /res/v1/providers:
    get:
      summary: Get All Providers
      description: >
        Retrieves the banks accessible for account data and payment initiation.
        The services available per bank are detailed under the `ais` and `pis`
        attributes — AIS values include Accountholders, Accounts, Transactions;
        PIS values include SEPA, iSCT, FPS, PLN, INT.
      operationId: getResV1Providers
      tags: [Providers]
      parameters:
        - in: query
          name: country
          schema: { type: string, description: "ISO 3166-1 alpha-2 country code" }
      responses:
        '200':
          description: Providers list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items: { $ref: '#/components/schemas/Provider' }

  /res/v1/providers/{provider_id}:
    get:
      summary: Get A Specific Provider
      operationId: getResV1Provider
      tags: [Providers]
      parameters:
        - in: path
          name: provider_id
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Provider details
          content:
            application/json:
              schema: { $ref: '#/components/schemas/Provider' }

  /res/v1/test-accounts:
    get:
      summary: Get All Test Accounts
      description: Retrieves test accounts by bank for use in the sandbox environment only.
      operationId: getResV1TestAccounts
      tags: [Test Accounts]
      responses:
        '200':
          description: Test accounts list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items: { $ref: '#/components/schemas/TestAccount' }

  /res/v1/test-accounts/{account_id}:
    get:
      summary: Get A Specific Test Account
      operationId: getResV1TestAccountById
      tags: [Test Accounts]
      parameters:
        - in: path
          name: account_id
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Test account details
          content:
            application/json:
              schema: { $ref: '#/components/schemas/TestAccount' }

components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
  schemas:
    Provider:
      type: object
      properties:
        id: { type: string }
        name: { type: string }
        country: { type: string }
        logo_url: { type: string, format: uri }
        auth_models:
          type: array
          items:
            type: string
            enum: [redirect, decoupled]
        ais:
          type: array
          items:
            type: string
            enum: [Accountholders, Accounts, Transactions]
        pis:
          type: array
          items:
            type: string
            enum: [SEPA, iSCT, FPS, PLN, INT]
        psu_types:
          type: array
          items:
            type: string
            enum: [retail, corporate]

    TestAccount:
      type: object
      properties:
        id: { type: string }
        provider_id: { type: string }
        iban: { type: string }
        bic: { type: string }
        holder_name: { type: string }
        balance: { type: string }
        currency: { type: string }

Fintecture Resources API

Documentation

Specifications

Other Resources

OpenAPI Specification