Payments APIInstitutions

Get institution details

GET
/institutions/{id}

Fetch particular institution details.

Authorization

Bearer
headerAuthorizationBearer <JWT>

Bearer token using a JWT.

Path Parameters

id*string

Identifier of the institution.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in1

Response Body

OK - Successful request, returning given institution's details.

application/json
  1. response
id?string

Identifier of the institution.

Formatuuid
country?string

Institution country.

Length2 <= length <= 2
name?string

Name of the institution.

localName?|

Localised name of the institution.

alternativeName?|

Alternative name of the institution.

Might be previous name, etc. Handy for search mechanisms on merchant's side.

group?

Institutions' group info.

branch?

Institution's branch info.

nationalId?|

National ID of the institution.

assets?

Graphical assets for the institution.

types?array<>

Institution type(s).

capabilities?

List of institution's capabilities with details.

Example Request
curl -X GET 'https://gateway.sandbox.volt.io/institutions/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-Volt-Api-Version: 1'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "country": "DE",  "name": "Sparkasse Nienburg",  "localName": "Sparkasse Nienburg",  "alternativeName": null,  "group": {    "name": "Sparkasse",    "localName": "Sparkasse"  },  "branch": {    "name": "Nienburg",    "localName": "Nienburg"  },  "nationalId": "25650106",  "assets": {    "icon": "http://cdn.example.com/assets/bank.svg",    "logo": "http://cdn.example.com/assets/bank.svg"  },  "types": [    "BUSINESS"  ],  "capabilities": {    "payments": {      "active": true,      "accountIdentifiersRequired": [        "IBAN"      ],      "additionalDataRequired": [],      "communication": {        "appToApp": "SUPPORTED"      },      "recurring": {        "commercial": false      }    }  }}