Retrieve dedicated bank account
curl --request GET \
--url https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Dedicated Bank Account
Retrieve dedicated account
Retrieve a dedicated account by external reference, account reference, or account number.
GET
/
v1
/
collections
/
dedicated-accounts
/
{reference}
Retrieve dedicated bank account
curl --request GET \
--url https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.oyapasteaza.com/v1/collections/dedicated-accounts/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": true,
"message": "<string>",
"data": {}
}{
"status": false,
"message": "<string>",
"code": "<string>"
}Use this endpoint to retrieve one dedicated account.
You can retrieve by
externalReference, accountReference, or accountNumber.
Endpoint
GET /v1/collections/dedicated-accounts/{reference}
Headers
Authorization: Bearer sk_test_xxx
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
reference | string | Yes | The externalReference, accountReference, or accountNumber. |
Example request
curl https://api.oyapasteaza.com/v1/collections/dedicated-accounts/CUS_001 \
-H "Authorization: Bearer sk_test_xxx"
Successful response
{
"status": true,
"message": "Dedicated account retrieved successfully.",
"data": {
"externalReference": "CUS_001",
"accountReference": "PZ_DCA_abc123",
"accountNumber": "8023456789",
"accountName": "LUCKY TECHNOLOGIES LTD",
"bankName": "PASTEAZA TEST BANK",
"status": "ACTIVE",
"totalReceived": 500000,
"transactionCount": 1,
"metadata": {
"customerId": "123",
"plan": "premium"
},
"createdAt": "2026-06-27T10:00:00.000Z",
"updatedAt": "2026-06-27T10:05:00.000Z"
}
}
Errors
| Code | Meaning |
|---|---|
authentication_failed | The API key is missing or invalid. |
validation_failed | reference is missing. |
dedicated_account_not_found | No dedicated account matched the supplied reference. |
Next step
List dedicated accounts
Retrieve active dedicated accounts for your merchant account.
Webhooks
Process dedicated account credit webhooks.
Authorizations
Use an sk_test_... key in the playground. Never enter a live key in shared environments.
Path Parameters
Pasteaza reference or supported merchant reference.