> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.paywithatoa.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Get List of Available Institutions or Banks

> Retrieve the list of supported UK banks and institutions for Atoa Pay by Bank payments, with logos and identifiers.

<img src="https://mintcdn.com/atoa-payments-limited/KEZXxpd7888D-dlX/images/bank.jpg?fit=max&auto=format&n=KEZXxpd7888D-dlX&q=85&s=1ae4a182e46a45ec86d15d9d75a19b4c" width="808" height="81" alt="Logos of major UK banks supported by Atoa, including Barclays, Lloyds, HSBC, NatWest, Santander, Monzo, TSB, first direct, Wise and Virgin Money." data-path="images/bank.jpg" />

Retrieve a comprehensive list of available institutions, accompanied by their respective images.

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "lloyds",
      "name": "Lloyds (Personal)",
      "fullName": "Lloyds (Personal)",
      "media": [
        {
          "type": "icon",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/lloyds_4x.webp"
        },
        {
          "type": "logo",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/lloyds_4x.webp"
        }
      ],
      "features": [
        "INITIATE_DOMESTIC_SINGLE_PAYMENT",
        "INITIATE_DOMESTIC_VARIABLE_RECURRING_PAYMENT_SWEEPING",
        "ACCOUNT_TRANSACTIONS",
        "ACCOUNTS",
        "ACCOUNT",
        "READ_DOMESTIC_SINGLE_REFUND",
        "CREATE_DOMESTIC_VARIABLE_RECURRING_PAYMENT_SWEEPING"
      ],
      "enabled": true,
      "orderBy": 999,
      "popularBank": false,
      "bankPhoneNumber": null,
      "transactionAmountLimit": null,
      "businessBank": null,
      "bankCode": "LOYD"
    },
    {
      "id": "bankofscotland",
      "name": "Bank of Scotland (Personal)",
      "fullName": "Bank of Scotland (Personal)",
      "media": [
        {
          "type": "logo",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/bank_of_scotland_4x.webp"
        },
        {
          "type": "icon",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/bank_of_scotland_4x.webp"
        }
      ],
      "features": [
        "INITIATE_DOMESTIC_SINGLE_PAYMENT",
        "INITIATE_DOMESTIC_VARIABLE_RECURRING_PAYMENT_SWEEPING",
        "ACCOUNT_TRANSACTIONS",
        "ACCOUNTS",
        "ACCOUNT",
        "READ_DOMESTIC_SINGLE_REFUND"
      ],
      "enabled": true,
      "orderBy": 999,
      "popularBank": false,
      "bankPhoneNumber": null,
      "transactionAmountLimit": null,
      "businessBank": null,
      "bankCode": "BOFS"
    },
    {
      "id": "rbs",
      "name": "Royal Bank of Scotland",
      "fullName": "Royal Bank of Scotland",
      "media": [
        {
          "type": "logo",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/rbs_4x.webp"
        },
        {
          "type": "icon",
          "source": "https://atoa-static-images.s3.eu-west-2.amazonaws.com/bank_logos/v3/rbs_4x.webp"
        }
      ],
      "features": [
        "INITIATE_DOMESTIC_SINGLE_PAYMENT",
        "INITIATE_DOMESTIC_VARIABLE_RECURRING_PAYMENT_SWEEPING",
        "ACCOUNT_TRANSACTIONS",
        "ACCOUNTS",
        "ACCOUNT"
      ],
      "enabled": true,
      "orderBy": 999,
      "popularBank": false,
      "bankPhoneNumber": null,
      "transactionAmountLimit": null,
      "businessBank": null,
      "bankCode": "RBSS"
    }
  ]
  ```

  ```json 500 theme={null}
  {
    "name": "INTERNAL_SERVER_ERROR",
    "message": "Error connecting to institution, please contact support if persists or try again later",
    "status": 500,
    "errors": "[]"
  }
  ```
</ResponseExample>

**Response**

<ResponseField name="id" type="string">
  Unique Institution id
</ResponseField>

<ResponseField name="name" type="string">
  Name of the Institution
</ResponseField>

<ResponseField name="fullName" type="string">
  Full name of the Institution
</ResponseField>

<ResponseField name="media" type="array">
  <Expandable>
    <ResponseField name="type" type="string">
      Type of media - `icon` or `logo`
    </ResponseField>

    <ResponseField name="source" type="string">
      URL of the image
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="features" type="array">
  List of supported features for this institution (e.g.,
  `INITIATE_DOMESTIC_SINGLE_PAYMENT`, `ACCOUNT_TRANSACTIONS`)
</ResponseField>

<ResponseField name="enabled" type="boolean">
  Whether the institution is currently enabled
</ResponseField>

<ResponseField name="orderBy" type="number">
  Sort order for displaying the institution
</ResponseField>

<ResponseField name="popularBank" type="boolean">
  Whether the institution is marked as a popular bank
</ResponseField>

<ResponseField name="bankPhoneNumber" type="string">
  Phone number of the bank (if available)
</ResponseField>

<ResponseField name="transactionAmountLimit" type="number">
  Transaction amount limit for the institution (if applicable)
</ResponseField>

<ResponseField name="businessBank" type="boolean">
  Whether this is a business banking institution
</ResponseField>

<ResponseField name="bankCode" type="string">
  Bank identifier code (e.g., SWIFT/BIC code)
</ResponseField>