GET
Account Details
Retrieve the complete details of a specific account using its account number.
GET/v2/account/{account_number}
Use this endpoint to fetch detailed information about a customer's account, including their current tier, KYC status, and linked BVN information.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_number | string | YES | The 10-digit account number you want to retrieve details for. |
Example Request
cURL
curl -X GET "https://sandbox.hexcore.io/v2/account/1234567890" \-H "Authorization: Bearer sk_test_your_secret_key"Example Response
JSON (200 OK)
{"status": true,"message": "Account details retrieved successfully","data": {"account_number": "1234567890","account_name": "JANE DOE","currency": "NGN","tier": 3,"status": "ACTIVE","created_at": "2026-05-01T14:32:01Z","customer": {"first_name": "Jane","last_name": "Doe","email": "jane.doe@example.com","phone_number": "+2348012345678"} } }