Skip to main content

Payments Banks

GET /api/v1/Payments/banks

Description

This endpoint is used to get a list of banks and their details.

Headers:

  • No specific headers are required.

Path Parameters:

  • version: The version of the API.

URL:

  • GET: /api/v1/Payments/banks

Response:

  • 200: Success, returns a list of banks.

Error Codes:

  • 500: Internal server error, something went wrong while processing the request.

Example Request URL:

GET /api/v1.0/Payments/banks
Content-Type: application/json

Example Response:

HTTP/1.1 200 OK
[ { "bankCode": "011", "bankName": "First Bank of Nigeria" }, { "bankCode": "232", "bankName": "Sterling Bank" }]

Notes:

  • The response includes a list of banks, where each bank has a bank code and bank name.

  • This endpoint can be useful for retrieving bank information before making a transaction.

Method: GET

/api/v1/Payments/banks

Headers

Content-TypeValue
Accepttext/plain

Response: 200

{
"succeeded": "<boolean>",
"message": "<string>",
"errors": [
"<string>",
"<string>"
],
"data": [
{
"name": "<string>",
"code": "<string>"
},
{
"name": "<string>",
"code": "<string>"
}
]
}

LANGUAGE

AUTHORIZATION

Bearer

CURL REQUEST


curl --request GET \ 
--url /api/v1/Payments/banks \
--header 'accept: application/json' \
--header 'content-type: application/json'

RESPONSE


Click Try It! to start a request and see the response here!