Get Bank Details

Retrieve detailed information for a specific bank using its FLUID identifier.

Endpoint

GET /api/v1/payment-providers/banks/:identifier

Authentication

Requires a valid Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_TOKEN

Path Parameters

Parameter	Type	Required	Description
identifier	string	Yes	FLUID Network bank identifier (e.g., "EXB", "DEM")

Request

Example Request

curl --request GET \
  --url https://api.fluid-network.com/api/v1/payment-providers/banks/EXB \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json'

Response

Success Response

Status Code: 200 OK

{
  "success": true,
  "data": {
    "name": "Example Bank Ghana",
    "identifier": "EXB",
    "country_code": "GH"
  }
}

Response Fields

Field	Type	Description
success	boolean	Indicates if the request was successful
data	object	Bank details object
data.name	string	Full name of the bank
data.identifier	string	FLUID Network bank identifier
data.country_code	string	ISO 3166-1 alpha-2 country code

Error Responses

Bank Not Found

Status Code: 404 Not Found

{
  "success": false,
  "error": {
    "code": 1404,
    "message": "Resource not found",
    "category": "general"
  }
}

Common Causes:

• Invalid or non-existent bank identifier
• Bank is no longer active in the FLUID Network

Unauthorized

Status Code: 401 Unauthorized

{
  "success": false,
  "error": {
    "code": 1401,
    "message": "Unauthorized",
    "category": "authentication"
  }
}

Usage Notes

• Bank identifiers are case-sensitive (use uppercase)
• This endpoint is useful for validating bank identifiers before creating debit requests
• Bank information is cached for improved performance
• If you need a list of all available banks, use the List All Banks endpoint

Common Bank Identifiers

Bank Name	Identifier
Example Bank Ghana	EXB
Demo Bank Ghana	DEM
Test Bank Ghana	TST
Sample Bank	SAM
Alpha Bank Ghana	ALF

Tip: To get the complete list of active bank identifiers, call the List All Banks endpoint.

Rate Limits

• Production: 200 requests per minute
• Sandbox: 60 requests per minute

Next Steps

• List all available banks
• Lookup customer banks
• Create a debit request