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 }