Get a static virtual account

curl --request GET \
  --url https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "sva_01JYK596NGYA1DQ91K5GQAPENE",
  "object": "virtual_account",
  "created_at": "2026-07-14T10:02:00Z",
  "updated_at": "2026-10-27T08:41:00Z",
  "type": "static",
  "customer": {
    "id": "cus_01JX45HY43KWJRP1XPA7Z3DJ8F",
    "name": "Kano Freight Services",
    "email": "ap@kanofreight.ng"
  },
  "reference": "CUST-0012",
  "account_name": "Adaeze Logistics / Kano Freight Services",
  "account_number": "9011284730",
  "bank_name": "Providus Bank",
  "bank_code": "101",
  "currency": "NGN",
  "settlement_account": {
    "id": "acc_01J26W14WMCHWYFGCW8T7SWM4F",
    "name": "Naira · Main",
    "account_number": "8012457739"
  },
  "status": "active",
  "payment_count": 14,
  "amount_collected": {
    "amount": 1845000000,
    "currency": "NGN"
  },
  "last_payment_at": "2026-10-27T08:41:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

GET

collections

virtual-accounts

{virtual_account_id}

Get a static virtual account

curl --request GET \
  --url https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/collections/virtual-accounts/{virtual_account_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "sva_01JYK596NGYA1DQ91K5GQAPENE",
  "object": "virtual_account",
  "created_at": "2026-07-14T10:02:00Z",
  "updated_at": "2026-10-27T08:41:00Z",
  "type": "static",
  "customer": {
    "id": "cus_01JX45HY43KWJRP1XPA7Z3DJ8F",
    "name": "Kano Freight Services",
    "email": "ap@kanofreight.ng"
  },
  "reference": "CUST-0012",
  "account_name": "Adaeze Logistics / Kano Freight Services",
  "account_number": "9011284730",
  "bank_name": "Providus Bank",
  "bank_code": "101",
  "currency": "NGN",
  "settlement_account": {
    "id": "acc_01J26W14WMCHWYFGCW8T7SWM4F",
    "name": "Naira · Main",
    "account_number": "8012457739"
  },
  "status": "active",
  "payment_count": 14,
  "amount_collected": {
    "amount": 1845000000,
    "currency": "NGN"
  },
  "last_payment_at": "2026-10-27T08:41:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Path Parameters

virtual_account_id

string

required

Static virtual account id (sva_…).

Pattern: ^sva_[0-9A-HJKMNP-TV-Z]{26}$

Response

The virtual account.

A static virtual account (sva_…), a permanent account number for one customer.

string

required

sva_…

object

string

required

Always virtual_account.

Allowed value: "virtual_account"

created_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

updated_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

type

string

required

Always static. Per-invoice accounts are on the invoice.

Allowed value: "static"

customer

object

required

The customer (payer) on an invoice or static virtual account.

Show child attributes

account_name

string

required

Name the sender's bank shows.

account_number

string

required

10-digit Nigerian NUBAN account number.

Pattern: ^\d{10}$

Example:

"8012457739"

bank_name

string

required

Partner bank.

currency

enum<string>

required

ISO 4217. Only NGN is live at launch; others return 422 currency_not_enabled.

Available options:

NGN,

USD,

GBP,

EUR,

GHS,

KES

settlement_account

object

required

One of the business's own PanoFlow accounts (owned by the Accounts service).

Show child attributes

status

enum<string>

required

active accepts transfers; closed does not (the bank rejects them). Closed accounts can be reopened.

Available options:

active,

closed

payment_count

integer

required

Credits received.

amount_collected

object

required

Total received.

Show child attributes

reference

string

Your own id for the customer.

bank_code

string

The bank's NIBSS NIP institution code (CBN bank code).

Example:

"058"

last_payment_at

string<date-time>

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

closed_at

string<date-time>

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

metadata

object

Up to 20 string keys (≤ 40 chars) with string values (≤ 500 chars). Returned on the resource and its events.

Show child attributes

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Get a static virtual account

Authorizations

Headers

Path Parameters

Response