Get Last Transfer Points

This endpoint returns the most recent 5 business accounts that the authenticated user has transferred points to. It is useful for populating a quick-select list of frequent transfer recipients in your UI, reducing friction for repeat transfers. The response includes each account's profile identifier and business contact details.

Endpoint

GET /lastTransferPoints

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 when presenting the authenticated business customer with a list of recent transfer recipients for point redemptions or rewards transfers. It streamlines the transfer flow by surfacing the last 5 destination accounts without requiring the user to search manually. This is particularly useful in rewards dashboards and points transfer screens.

Response

200 OK

Returns an array of up to 5 business account objects.

[
  {
    "profileId": 100234,
    "doingBusinessName": "Acme Supplies LLC",
    "businessPhoneNumber": "+1-555-000-1234"
  },
  {
    "profileId": 100189,
    "doingBusinessName": "Blue River Consulting",
    "businessPhoneNumber": "+1-555-000-5678"
  },
  {
    "profileId": 100045,
    "doingBusinessName": "Summit Tech Group",
    "businessPhoneNumber": "+1-555-000-9012"
  }
]

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token will result in a 401 error; ensure the token has not expired (lifetime is 10 minutes).
• This endpoint returns at most 5 results regardless of transfer history length; do not attempt to paginate or pass offset parameters.
• doingBusinessName and businessPhoneNumber may be null if the recipient account has not completed their business profile; always handle nullable fields gracefully in your UI.
• This endpoint is intended for business customer contexts only; personal customer accounts do not have points transfer history.

Related Endpoints

• POST /api/auth/v2 — Obtain a Bearer authentication token
• POST /api/auth/refresh — Refresh an existing Bearer token
• GET /search — Search for Netevia business accounts by name or other criteria

Example

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