Check personal-line account-opening progress
On behalf of a member ·
x-on-behalf-of required
⚠ Use stage; do not combine two statuses yourself
This flow has two statuses: our review, application.status, and upstream account opening. Whether the member can currently place a personal-line order is a function of both, which we combine into stage.
Combining them yourself will eventually diverge from our decision. A common case is allowing orders after our approval while the upstream is still reviewing: funds become locked, dispatch fails, and the funds are held in a bucket neither the member nor normal operations can unlock.
Only stage equal to ready permits orders with line: "pobo".
Request Headers
| Field | Type | Required | Description |
|---|---|---|---|
x-on-behalf-of |
string | Required | Member to query. |
Response
200If no application was ever submitted,
application is null, not omitted.{
"application": {
"id": "vpa_12",
"status": "reviewing",
"reviewed_at": "",
"created_at": "2026-08-13T20:00:00.000Z"
},
"stage": "reviewing"
}403
insufficient_scope: missing remittances:read404
member_not_foundRequest
curl -X GET 'https://api.zinfra.vip/v1/remit/vp/applications' \
-H 'x-auth-token: Bearer $TOKEN' \
-H 'x-on-behalf-of: $MEMBER_ID'const res = await fetch("https://api.zinfra.vip/v1/remit/vp/applications", {
method: "GET",
headers: {
"x-auth-token": "Bearer $TOKEN",
"x-on-behalf-of": "$MEMBER_ID",
},
});
// Keep monetary amounts as strings, never numbers.
const data = await res.json();import requests
res = requests.get(
"https://api.zinfra.vip/v1/remit/vp/applications",
headers={
"x-auth-token": "Bearer $TOKEN",
"x-on-behalf-of": "$MEMBER_ID",
},
)
# Use Decimal(str(...)) for amounts, not float.
data = res.json()req, _ := http.NewRequest("GET", "https://api.zinfra.vip/v1/remit/vp/applications",
nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// Decode amount fields as string, not float64.HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://api.zinfra.vip/v1/remit/vp/applications"))
.header("x-auth-token", "Bearer $TOKEN")
.header("x-on-behalf-of", "$MEMBER_ID")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
// Use String / BigDecimal for amounts, not double.$ch = curl_init('https://api.zinfra.vip/v1/remit/vp/applications');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'x-auth-token: Bearer $TOKEN',
'x-on-behalf-of: $MEMBER_ID',
],
]);
$res = curl_exec($ch);
// Use bcmath / strings for amounts, not floatval.
200
{
"application": {
"id": "vpa_12",
"status": "reviewing",
"reviewed_at": "",
"created_at": "2026-08-13T20:00:00.000Z"
},
"stage": "reviewing"
}