--- swagger: "2.0" info: x-ibm-name: accounts-open-business title: Accounts Open Business version: 1.0.3 description: |- ## This API will allow AISP (Account Information Service Provider) to get the information related to the accounts of the Banco Santander client in her name. ####A Sandbox version of this API is also available. schemes: - https consumes: - application/json produces: - application/json securityDefinitions: clientIdHeader: type: apiKey in: header name: X-IBM-Client-Id description: This parameter is the ID that identifies the TPP API that has been registered in the API Portal previously. Serenity-OAuth: type: oauth2 description: Servidor Oauth Corporativo del Banco Santander flow: accessCode x-santander-refresh-token: true scopes: accounts: Permitir la lectura de info sobre las cuentas del usuario tokenUrl: https://sos-psd2-gateway-san-estruc-api-dev.appls.boaw.paas.gsnetcloud.corp/oauth/token authorizationUrl: https://sos-psd2-gateway-san-estruc-api-dev.appls.boaw.paas.gsnetcloud.corp/authorize security: - clientIdHeader: [] x-ibm-configuration: testable: true enforced: true phase: realized paths: /: get: responses: 200: description: 200 OK schema: $ref: '#/definitions/accounts' 400: description: 400 Bad request schema: $ref: '#/definitions/custom-error' 401: description: 401 Unauthorized request schema: $ref: '#/definitions/custom-error' 404: description: 404 Resource not found schema: $ref: '#/definitions/custom-error' 429: description: 429 Too many requests schema: $ref: '#/definitions/custom-error' 500: description: 500 Internal error schema: $ref: '#/definitions/custom-error' x-santander-security: - OAuth2_Access-Code: - accounts parameters: [] parameters: - name: Authorization type: string required: true in: header description: The API is protected by the authorization header. The TPP must indicate the access_token obtained by the during the consent process. - name: psu_active type: string required: true in: header description: This parameter indicates if the Banco Santander client is present in the request or not. - name: interaction-Id type: string required: false in: header description: Unique identifier of the request. It can be optionally especified by the TPP to monitorize the request. It will be included as a parameter in the response. /{iban}: get: responses: 200: description: 200 OK x-santander-security: - OAuth2_Access-Code: - accounts parameters: - name: iban type: string required: true in: path description: required iban - name: withBalance type: boolean required: false in: query description: Show account Balance - name: Authorization type: string required: true in: header description: The API is protected by the authorization header. The TPP must indicate the access_token obtained by the during the consent process. - name: psu_active type: string required: true in: header description: This parameter indicates if the Banco Santander client is present in the request or not. - name: interaction-id type: string required: false in: header description: Unique identifier of the request. It can be optionally especified by the TPP to monitorize the request. It will be included as a parameter in the response. definitions: link-array: type: object description: '> Link that includes the URL of interest for the request.' custom-error: properties: developerMessage: type: string example: ClientId in signature token differs from the ClientId associated to the access token description: Message that is send to the developer. userMessage: type: string description: Message that is sent to the user. example: The operation can not be reached. status: type: string description: HTTP Status of the error. example: "401" moreInfo: type: string description: More information related to the errors. example: https://developer.bancosantander.es/api/errors/GOIT_001 code: type: string description: Unique identifier for the error code. example: GOIT_001 additionalProperties: false required: - code - userMessage - moreInfo - status - developerMessage description: '> This object specifies the structure of the errors that can be given during the execution of the API.' accounts: properties: _links: $ref: '#/definitions/link-array' description: Links of interest for each request. example: '{ "self": { "href": "https://api.bancosantander.es/accounts" }, "all-transactions": { "href": "https://api.bancosantander.es/movements" }' accounts: $ref: '#/definitions/accounts-array' example: '[ { "currency": "EUR", "balance": "+88676.00", "alias": "CUENTA 1 2 3", "iban": "ES2900490075412616078374" } ]' description: This parameter indicates the accounts of the Banco Santander client. Request-ID: type: string example: aaa##e42f6b0f-d0b3-4640-a326-810fdddd0c7c description: 'Autogenerated identifier for the request. It will be concatened with the interaction-id especified in the request. The format will be: Interaction-Id ### Request-ID.' additionalProperties: false required: - accounts - _links - Request-ID description: '> This is the information that will be included in the body of the reponse.' accounts-array: type: array items: $ref: '#/definitions/account-status' description: This field is included in the **_"accounts"_** item and will contain an array of **_"account-status"_** type items. account-status: properties: creditDebitIndicator: type: string description: Credit/Debit indicator. Indicates if the balances is credit or debit. If the balance is equal to zero, it takes the value of credit. example: DBIT change: type: number description: 'Variation: this value is calculated as the difference between the available balance now and the available balance yesterday. It only applies for business.' format: double example: 120 currency: type: string description: Currency. example: EUR balance: type: number description: Available balance. format: double example: 1240 alias: type: string description: Alias/description of the account. example: Cuenta 1 2 3 iban: type: string description: IBAN. example: ES2200499135900141787700 showMovements: type: boolean example: "true" additionalProperties: false description: '> For each account the following information will be given in the response to the AISP.' required: - iban - alias - balance - currency - creditDebitIndicator tags: [] basePath: /v2/accounts x-ibm-endpoints: - endpointUrl: https://apis-sandbox.bancosantander.es/canales-digitales/sb type: - production ...