List family profiles on this phone

List family profiles on this phone

When to call: family picker / switch-profile screen. After OTP when you need to refresh accounts, or after login when the app shows who else is on this number.

Why: OTP already returns the list, but the app should not have to verify OTP again just to re-draw the picker. Same phone, same PAN-verified members.

What it does: query phoneSessionToken (from OTP, ~10 min) or Bearer. Response is { accounts[], canAddAccount }. accounts is only Customers whose PAN succeeded on this number — a User draft is not listed. displayName / maskedPan may be null until profile / PAN data exists. Max five members; canAddAccount is false at the cap.

What happens next: POST /auth/accounts/select with phoneSessionToken + accounts[].id, or POST /auth/accounts to add someone. After login, GET /application/profile is that person's full form — this list is picker cards only.

Auth: public (no Bearer).

Errors: 401 unauthorized | session_expired

{ "canAddAccount": true, "accounts": [ { "id": "cust_1735123456789", "kind": "customer", "displayName": "Rajavarapu Yaswanth Kumar", "maskedPan": "XXXXXX085R" }, { "id": "cust_1735987654321", "kind": "customer", "displayName": "Family member", "maskedPan": "XXXXXX123A" } ] }

List family profiles on this phone

Request

Responses