---
title: "Get Financial Institutions by Role"
method: GET
path: "/v1/fin-insts/{finInstRole}"
tags: ["Financial Institutions (PSPs, FXPs and SAPs)"]
---

# Get Financial Institutions by Role

`GET /v1/fin-insts/{finInstRole}`

Returns a list of financial institutions available in Nexus, for the specified role, for all countries.

## Path parameters

- `finInstRole` 'psp' | 'fxp' | 'sap' | 'any', required

## Response `200`

Successful response

## Other responses

- `400` — Unsupported role. Reason code BE016 FI_ROLE_UNSUPPORTED.
- `401` — Authentication failed. Applicable reason codes: AE001 AUTH_TOKEN_MISSING, AE002 AUTH_TOKEN_INVALID.
- `403` — Authorization failed. The token is valid but its OAuth2 scopes do not grant access to this endpoint or corridor. Reason code AE004 ACCESS_DENIED.
- `429` — Rate limit exceeded. Returned by the API gateway and carries no structured Nexus body. The Retry-After response header indicates when to retry.
- `500` — An unhandled exception or infrastructure failure occurred. Reason code TE099 INTERNAL_ERROR. The caller may retry with exponential backoff.

---

[API](https://skmtc.net/nexusglobalpayments/apis/nexus-apis.md) · [All operations](https://skmtc.net/nexusglobalpayments/apis/nexus-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nexusglobalpayments/nexus-apis/revisions/b3e625f21841/schema)