Get Account Holder Name

The GET /api/welcome/v2 endpoint retrieves the first and last name of the primary authorized person associated with the authenticated account. For business customers, it returns the name of the primary authorized person on the account. For personal customers, it returns the customer's own first and last name.

Endpoint

GET /api/welcome/v2

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint immediately after login to retrieve the account holder's name for personalized greeting messages or user interface displays. It is also useful when rendering account dashboards, email templates, or any in-app communication that requires addressing the customer by name. No request body or query parameters are needed, making it a lightweight call suitable for frequent use.

Response

200 OK

{
  "value": "Jane Smith"
}

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token will result in a 401 error; ensure the token has not expired (10-minute lifetime).
• The response wraps the name string in a value field — do not expect a plain string response; parse the JSON object and access value.
• For business accounts with multiple authorized users (subProfiles), this endpoint returns the name of the primary account holder, not a subProfile user.

Related Endpoints

• POST /api/auth/v2 — Obtain a Bearer token using username, password, and partnerId
• POST /api/auth/refresh — Refresh an existing Bearer token before it expires
• GET /api/profile/v2 — Retrieve full profile details for the authenticated customer

Example

curl -X GET https://api.banking.netevia.dev/api/welcome/v2 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"