--- updatedAt: 2026-06-04T16:54:59.000Z agentTools: projectIndex: https://doc.fintecture.com/llms.txt --- # Get a specific provider This endpoint provides information on a specific settlement # 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/{provider_id}": { "get": { "security": [ { "ApikeyAuth": [] } ], "tags": [ "providers" ], "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": "getResV1Provider", "summary": "Get a specific provider", "description": "This endpoint provides information on a specific settlement" }, "parameters": [ { "$ref": "#/components/parameters/Path-providerId-req" } ] } }, "components": { "parameters": { "Path-providerId-req": { "name": "provider_id", "description": "the provider id as returned by the providers resource", "schema": { "type": "string", "example": "bankfr" }, "in": "path", "required": true } }, "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" }, "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" } ] } ```