---
updatedAt: 2026-06-04T16:54:59.000Z
agentTools:
  projectIndex: https://doc.fintecture.com/llms.txt
---

# Get all providers

This endpoint retrieves the banks to which you can access account data and initiate payments.

The services provided by the banks are detailed in the ‘ais’ and ‘pis’ attributes, and can be:

- AIS: Accountholders, Accounts, Transactions
- PIS: SEPA, iSCT, FPS, PLN, INT

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "API EXPLORER",
    "version": "3.0.0",
    "description": "Public API\n",
    "contact": {
      "name": "Support",
      "email": "noelia.rodriguez@fintecture.com"
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "samples-languages": [
      "curl",
      "javascript",
      "ruby"
    ]
  },
  "servers": [
    {
      "url": "https://api.sandbox.fintecture.com",
      "description": "Sandbox server"
    },
    {
      "url": "https://api.fintecture.com",
      "description": "Production server"
    }
  ],
  "paths": {
    "/res/v1/providers": {
      "get": {
        "security": [
          {
            "ApikeyAuth": []
          }
        ],
        "tags": [
          "providers"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Query-filterCountry"
          },
          {
            "$ref": "#/components/parameters/Query-filterAis"
          },
          {
            "$ref": "#/components/parameters/Query-filterPis"
          },
          {
            "$ref": "#/components/parameters/Query-filterPsuType"
          },
          {
            "$ref": "#/components/parameters/Query-filterAuthModel"
          },
          {
            "$ref": "#/components/parameters/Query-filterScheme"
          },
          {
            "$ref": "#/components/parameters/Query-sortName"
          },
          {
            "$ref": "#/components/parameters/Query-sortFullName"
          },
          {
            "$ref": "#/components/parameters/Query-sortCountry"
          },
          {
            "$ref": "#/components/parameters/Query-sortProviderId"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResV1Provider"
                }
              }
            },
            "description": "successful operation"
          },
          "400": {
            "$ref": "#/components/responses/400-BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401-Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403-Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404-NotFound"
          },
          "500": {
            "$ref": "#/components/responses/500-InternalServerError"
          }
        },
        "operationId": "getResV1Providers",
        "summary": "Get all providers",
        "description": "This endpoint retrieves the banks to which you can access account data and initiate payments.\n\nThe services provided by the banks are detailed in the ‘ais’ and ‘pis’ attributes, and can be:\n\n- AIS: Accountholders, Accounts, Transactions\n- PIS: SEPA, iSCT, FPS, PLN, INT"
      }
    }
  },
  "components": {
    "parameters": {
      "Query-filterAuthModel": {
        "name": "filter[auth_model]",
        "description": "Filter based on authentication models",
        "schema": {
          "$ref": "#/components/schemas/OAuthModel"
        },
        "in": "query"
      },
      "Query-filterScheme": {
        "name": "filter[scheme]",
        "description": "Filter based on Scheme",
        "schema": {
          "$ref": "#/components/schemas/PaymentScheme"
        },
        "in": "query"
      },
      "Query-filterCountry": {
        "name": "filter[country]",
        "description": "filter providers by country",
        "schema": {
          "$ref": "#/components/schemas/CountryCode"
        },
        "in": "query"
      },
      "Query-filterAis": {
        "name": "filter[ais]",
        "description": "filter providers by AIS services available",
        "schema": {
          "type": "string"
        },
        "in": "query"
      },
      "Query-filterPis": {
        "name": "filter[pis]",
        "description": "filter providers by PIS services available",
        "schema": {
          "type": "string"
        },
        "in": "query"
      },
      "Query-filterPsuType": {
        "name": "filter[psu_type]",
        "description": "filter providers based on supported PSU types",
        "schema": {
          "$ref": "#/components/schemas/PsuType"
        },
        "in": "query"
      },
      "Query-sortName": {
        "name": "sort[name]",
        "description": "sorts the providers by name",
        "schema": {
          "enum": [
            "ASC",
            "DESC"
          ],
          "type": "string",
          "example": "ASC"
        },
        "in": "query"
      },
      "Query-sortFullName": {
        "name": "sort[full_name]",
        "description": "sorts the providers by full name",
        "schema": {
          "enum": [
            "ASC",
            "DESC"
          ],
          "type": "string",
          "example": "ASC"
        },
        "in": "query"
      },
      "Query-sortCountry": {
        "name": "sort[country]",
        "description": "sorts the providers by country",
        "schema": {
          "enum": [
            "ASC",
            "DESC"
          ],
          "type": "string",
          "example": "ASC"
        },
        "in": "query"
      },
      "Query-sortProviderId": {
        "name": "sort[provider_id]",
        "description": "sorts the providers by provider code",
        "schema": {
          "enum": [
            "ASC",
            "DESC"
          ],
          "type": "string",
          "example": "ASC"
        },
        "in": "query"
      }
    },
    "responses": {
      "400-BadRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/APIResponse400"
            }
          }
        },
        "description": "bad request"
      },
      "401-Unauthorized": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/APIResponse401"
            }
          }
        },
        "description": "unauthorized"
      },
      "403-Forbidden": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/APIResponse403"
            }
          }
        },
        "description": "forbidden"
      },
      "404-NotFound": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/APIResponse404"
            }
          }
        },
        "description": "resource not found"
      },
      "500-InternalServerError": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/APIResponse500"
            }
          }
        },
        "description": "internal server error"
      }
    },
    "schemas": {
      "AisModel": {
        "title": "AIS Model (Enum)",
        "description": "",
        "enum": [
          "AccountHolders",
          "Accounts",
          "Transactions"
        ],
        "type": "string",
        "example": "Accounts"
      },
      "Amount": {
        "title": "Amount",
        "description": "Description of an amount @Fintecture",
        "type": "string",
        "pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
        "example": "273.00"
      },
      "APIResponse400": {
        "title": "400 API Response",
        "description": "Definition of the standard API reponse when a 400",
        "type": "object",
        "properties": {
          "status": {
            "format": "int32",
            "description": "HTTP status code",
            "type": "integer",
            "example": 400
          },
          "code": {
            "type": "string",
            "enum": [
              "bad_request",
              "provider_error"
            ],
            "example": "bad_request"
          },
          "log_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IdentifierUuidV4"
              },
              {
                "description": "Log unique identifier"
              }
            ]
          },
          "errors": {
            "description": "Errors returned",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/APIResponse400Error"
            }
          }
        }
      },
      "APIResponse400Error": {
        "title": "API Response 400 Error",
        "description": "API Response 400 Error description",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "bad_request",
              "customer_unknown",
              "account_unknown",
              "session_id_invalid_or_expired",
              "invalid_field",
              "mandatory_field_missing",
              "invalid_debited_account"
            ],
            "example": "bad_request"
          },
          "title": {
            "description": "Title message",
            "type": "string",
            "example": "Bad request"
          },
          "message": {
            "description": "Error message",
            "type": "string",
            "example": "Invalid parameters or malformed syntax."
          }
        }
      },
      "APIResponse401": {
        "title": "401 API Response",
        "description": "Definition of the standard API reponse when a 401",
        "type": "object",
        "properties": {
          "status": {
            "format": "int32",
            "description": "HTTP status code",
            "type": "integer",
            "example": 401
          },
          "code": {
            "type": "string",
            "enum": [
              "unauthorized"
            ],
            "example": "unauthorized"
          },
          "log_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IdentifierUuidV4"
              },
              {
                "description": "Log unique identifier"
              }
            ]
          },
          "errors": {
            "description": "Errors returned",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/APIResponse401Error"
            }
          }
        }
      },
      "APIResponse401Error": {
        "title": "API Response 401 Error",
        "description": "API Response 401 Error description",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "invalid_token",
              "invalid_scopes",
              "invalid_code",
              "invalid_app_id",
              "invalid_app_url"
            ],
            "example": "bad_request"
          },
          "title": {
            "description": "Title message",
            "type": "string",
            "example": "Invalid token"
          },
          "message": {
            "description": "Error message",
            "type": "string",
            "example": "The token is either invalid or expired."
          }
        }
      },
      "APIResponse403": {
        "title": "403 API Response",
        "description": "Definition of the standard API reponse when a 403",
        "type": "object",
        "properties": {
          "status": {
            "format": "int32",
            "description": "HTTP status code",
            "type": "integer",
            "example": 403
          },
          "code": {
            "type": "string",
            "enum": [
              "forbidden"
            ],
            "example": "forbidden"
          },
          "log_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IdentifierUuidV4"
              },
              {
                "description": "Log unique identifier"
              }
            ]
          },
          "errors": {
            "description": "Errors returned",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/APIResponse403Error"
            }
          }
        }
      },
      "APIResponse403Error": {
        "title": "API Response 403 Error",
        "description": "API Response 403 Error description",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "forbidden"
            ],
            "example": "forbidden"
          },
          "title": {
            "description": "Title message",
            "type": "string",
            "example": "Forbidden"
          },
          "message": {
            "description": "Error message",
            "type": "string",
            "example": "Access Forbidden."
          }
        }
      },
      "APIResponse404": {
        "title": "404 API Response",
        "description": "Definition of the standard API reponse when a 404",
        "type": "object",
        "properties": {
          "status": {
            "format": "int32",
            "description": "HTTP status code",
            "type": "integer",
            "example": 404
          },
          "code": {
            "type": "string",
            "enum": [
              "not_found"
            ],
            "example": "not_found"
          },
          "log_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IdentifierUuidV4"
              },
              {
                "description": "Log unique identifier"
              }
            ]
          },
          "errors": {
            "description": "Errors returned",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/APIResponse404Error"
            }
          }
        }
      },
      "APIResponse404Error": {
        "title": "API Response 404 Error",
        "description": "API Response 404 Error description",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "not_found"
            ],
            "example": "not_found"
          },
          "title": {
            "description": "Title message",
            "type": "string",
            "example": "Not found"
          },
          "message": {
            "description": "Error message",
            "type": "string",
            "example": "The requested resource could not be found. The requested resource either does not exist or is temporarily down."
          }
        }
      },
      "APIResponse500": {
        "title": "500 API Response",
        "description": "Definition of the standard API reponse when a 500",
        "type": "object",
        "properties": {
          "status": {
            "format": "int32",
            "description": "HTTP status code",
            "type": "integer",
            "example": 500
          },
          "code": {
            "type": "string",
            "enum": [
              "internal_server_error"
            ],
            "example": "internal_server_error"
          },
          "log_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/IdentifierUuidV4"
              },
              {
                "description": "Log unique identifier"
              }
            ]
          },
          "errors": {
            "description": "Errors returned",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/APIResponse500Error"
            }
          }
        }
      },
      "APIResponse500Error": {
        "title": "API Response 500 Error",
        "description": "API Response 500 Error description",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "internal_server_error"
            ],
            "example": "internal_server_error"
          },
          "title": {
            "description": "Title message",
            "type": "string",
            "example": "Internal Server Error"
          },
          "message": {
            "description": "Error message",
            "type": "string",
            "example": "An internal error has occurred. If the error persists, please contact our support."
          }
        }
      },
      "Bic": {
        "title": "BIC",
        "description": "BIC",
        "type": "string",
        "example": "CMCIFR2AXXX"
      },
      "CountryCode": {
        "title": "Country code",
        "description": "country code like described in the ISO 3166-1 alpha-2 ",
        "maxLength": 2,
        "minLength": 2,
        "type": "string",
        "example": "FR"
      },
      "IdentifierUuidV4": {
        "title": "UUID V4 identifier",
        "description": "UUID V4 identifier",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "type": "string",
        "example": "dc5b0048-2a80-4a22-b2f9-fad7d72f074d"
      },
      "OAuthModel": {
        "title": "oAuth models (Enum)",
        "description": "",
        "enum": [
          "decoupled",
          "redirect"
        ],
        "type": "string",
        "example": "decoupled"
      },
      "PaymentScheme": {
        "title": "Payment Scheme (Enum)",
        "description": "The payment scheme to use. Default: `AUTO` (automatic selection), `SEPA`, `INSTANT_SEPA`",
        "enum": [
          "AUTO",
          "SEPA",
          "INSTANT_SEPA"
        ],
        "type": "string",
        "example": "SEPA"
      },
      "PisModel": {
        "title": "PIS Model (Enum)",
        "description": "",
        "enum": [
          "SEPA"
        ],
        "type": "string",
        "example": "SEPA"
      },
      "PsuType": {
        "title": "PSU type (Enum)",
        "description": "Type of PSU",
        "enum": [
          "retail",
          "corporate",
          "all"
        ],
        "type": "string",
        "example": "all"
      },
      "ResV1Provider": {
        "title": "Bank provider",
        "description": "Bank provider",
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "type"
              ],
              "properties": {
                "id": {
                  "description": "Provider resource identifier",
                  "type": "string",
                  "example": "bankfr"
                },
                "type": {
                  "type": "string",
                  "description": "Resource type",
                  "enum": [
                    "provider"
                  ],
                  "example": "provider"
                },
                "attributes": {
                  "type": "object",
                  "required": [
                    "id",
                    "provider",
                    "name",
                    "full_name",
                    "swift_bic",
                    "country",
                    "country_full",
                    "ais",
                    "pis",
                    "has_app_to_app",
                    "min_amount",
                    "max_amount",
                    "has_pending_status",
                    "auth_models",
                    "psu_types",
                    "logo_url",
                    "has_scheduled_payments",
                    "has_account_holders",
                    "has_account",
                    "has_accounts",
                    "has_transactions",
                    "has_payments",
                    "has_payments_instant_sepa",
                    "has_completed_status",
                    "auth_default_model",
                    "is_available",
                    "has_inst_fee_refunds",
                    "has_direct_settlement",
                    "isct_fee_policy",
                    "isct_max_amount",
                    "isct_min_amount",
                    "forbid_isct_within_same_bank",
                    "direct_b2b_sct_policy",
                    "has_confirmation"
                  ],
                  "properties": {
                    "id": {
                      "description": "Provider internal identifier",
                      "type": "number",
                      "format": "integer",
                      "example": 1
                    },
                    "provider": {
                      "description": "Provider slug",
                      "type": "string",
                      "example": "bankfr"
                    },
                    "name": {
                      "description": "Provider name",
                      "type": "string",
                      "example": "Provider Bank"
                    },
                    "full_name": {
                      "description": "Provider full name",
                      "type": "string",
                      "example": "Provider Bank full name"
                    },
                    "swift_bic": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Bic"
                        },
                        {
                          "description": "Swift or BIC associated to the bank"
                        }
                      ]
                    },
                    "country": {
                      "$ref": "#/components/schemas/CountryCode"
                    },
                    "country_full": {
                      "description": "Provider's Country name",
                      "type": "string",
                      "example": "France"
                    },
                    "ais": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/AisModel"
                      }
                    },
                    "pis": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PisModel"
                      }
                    },
                    "has_app_to_app": {
                      "description": "Indicates if provider supports App2App",
                      "type": "boolean",
                      "example": false
                    },
                    "min_amount": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Amount"
                        },
                        {
                          "description": "Minimum amount used to be used with the provider"
                        },
                        {
                          "example": "0,00"
                        }
                      ]
                    },
                    "max_amount": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Amount"
                        },
                        {
                          "description": "Maximum amount used to be used with the provider"
                        },
                        {
                          "nullable": true
                        }
                      ]
                    },
                    "has_pending_status": {
                      "description": "Indicates if provider supports pending status",
                      "type": "boolean",
                      "example": false
                    },
                    "auth_models": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/OAuthModel"
                      }
                    },
                    "pis_account_selection\"": {
                      "type": "string",
                      "enum": [
                        "pisp",
                        "aspsp"
                      ],
                      "example": "pisp"
                    },
                    "psu_types": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PsuType"
                      }
                    },
                    "logo_url": {
                      "description": "Url where provider's logo can be found",
                      "type": "string",
                      "example": "https://assets-test.fintecture.com/img/providers/svg/spk-x.svg"
                    },
                    "has_scheduled_payments": {
                      "description": "Indicates if provider supports scheduled payments",
                      "type": "boolean",
                      "example": false
                    },
                    "has_account_holders": {
                      "description": "Indicates if provider provides account holders",
                      "type": "boolean",
                      "example": false
                    },
                    "has_account": {
                      "description": "Indicates if provider returns specific bank account",
                      "type": "boolean",
                      "example": false
                    },
                    "has_accounts": {
                      "description": "Indicates if provider returns all bank accounts",
                      "type": "boolean",
                      "example": false
                    },
                    "has_transactions": {
                      "description": "Indicates if provider returns all transactions",
                      "type": "boolean",
                      "example": false
                    },
                    "has_payments": {
                      "description": "Indicates if provider supports payments",
                      "type": "boolean",
                      "example": false
                    },
                    "has_payments_sepa": {
                      "description": "Indicates if provider supports SEPA payments",
                      "type": "boolean",
                      "example": false
                    },
                    "has_payments_instant_sepa": {
                      "description": "Indicates if provider supports INST payments",
                      "type": "boolean",
                      "example": false
                    },
                    "has_completed_status": {
                      "description": "Indicates if provider supports completed status",
                      "type": "boolean",
                      "example": false
                    },
                    "auth_default_model": {
                      "$ref": "#/components/schemas/OAuthModel"
                    },
                    "is_available": {
                      "description": "Indicates if provider is available",
                      "type": "boolean",
                      "example": false
                    },
                    "has_inst_fee_refunds": {
                      "description": "Indicates if provider supports instant fee refunds",
                      "type": "boolean",
                      "example": false
                    },
                    "has_direct_settlement": {
                      "description": "Indicates if provider supports direct settlement",
                      "type": "boolean",
                      "example": false
                    },
                    "isct_fee_policy": {
                      "description": "Fee policy for Instant Payments",
                      "type": "string",
                      "enum": [
                        "FROM_BANK",
                        "FREE"
                      ],
                      "nullable": true,
                      "example": "null,"
                    },
                    "isct_max_amount": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Amount"
                        },
                        {
                          "nullable": true
                        },
                        {
                          "description": "Maximum amount allowed when an Instant Payment"
                        }
                      ]
                    },
                    "isct_min_amount": {
                      "allOf": [
                        {
                          "$ref": "#/components/schemas/Amount"
                        },
                        {
                          "nullable": true
                        },
                        {
                          "description": "Minimum amount allowed when an Instant Payment"
                        }
                      ]
                    },
                    "forbid_isct_within_same_bank": {
                      "description": "Indicates if intra provider payments are forbidden",
                      "type": "boolean",
                      "example": false
                    },
                    "direct_b2b_sct_policy": {
                      "description": "Indicates policy for B2B SCT",
                      "type": "string",
                      "enum": [
                        "SEPA"
                      ],
                      "example": "SEPA"
                    },
                    "has_confirmation": {
                      "description": "Indicates if provider provides confirmation",
                      "type": "boolean",
                      "example": false
                    },
                    "account_identifier": {
                      "description": "Account identifier method",
                      "type": "string",
                      "enum": [
                        "iban",
                        "deutschebank",
                        "national_id",
                        "mobile_bank_id"
                      ],
                      "example": "iban"
                    },
                    "parent": {
                      "type": "object",
                      "required": [
                        "provider",
                        "name",
                        "country",
                        "country_full"
                      ],
                      "properties": {
                        "provider": {
                          "description": "Parent provider slug",
                          "type": "string",
                          "example": "bank-x"
                        },
                        "name": {
                          "description": "Parent provider name",
                          "type": "string",
                          "example": "My Parent Bank"
                        },
                        "country": {
                          "$ref": "#/components/schemas/CountryCode"
                        },
                        "country_full": {
                          "description": "Parent country full name",
                          "type": "string",
                          "example": "France"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "ApikeyAuth": {
        "type": "apiKey",
        "description": "The app_id as provided following the creation of an application in the console",
        "x-default": "dc5b0048-2a80-4a22-b2f9-fad7d72f074d",
        "in": "header",
        "name": "app_id"
      }
    }
  },
  "tags": [
    {
      "name": "providers",
      "description": "Provider related endpoints",
      "x-displayName": "Provider"
    }
  ]
}
```