Resident lookup

Single-file API example

Not connected

The same API login as Cycles. Your bearer session is remembered until logout or expiry; your API key is never stored.

Open this example locally

Save this one file as resident-lookup.html. In its folder run python -m http.server 8080 --bind 127.0.0.1, then open http://localhost:8080/resident-lookup.html and choose your tenant and environment. Internet access and an updated API are required. Opening the file directly supports the demo only.

Required permissions: Users2 (53), User Read and matching bank/location grants. Bank Read adds bank names. Normal manager and tenant checks apply to every page.

Residents · Across banks

Resident lookup

—

Find residents by email, phone, activation code or KID across every bank you can access on this tenant. Open a Nortec resident’s eVaskeri account in a new window.

Enter a complete email address. Your search and results are not saved in browser storage or the page URL.

Connect to look up a resident, or try the demo.

Enter a complete email address or phone number.

API operations and limitations

All lookups use the shared manager bearer session. Requires Users2 (53), User Read and current resource grants. Location grants include only associated, visible residents. The API searches this site's authorized banks, never another tenant. Bank Read adds parent-bank names; a missing name remains unavailable. Cards join each resident's bankKid to authorized bank context by KID.

The API returns at most 50 residents and examines at most 501 candidates; hasMore means the result may be incomplete. There is no cursor or total count. Results are cached for up to 60 seconds; current access and RetentionDays are checked on every request. The email provider can also match an exact stored name or number; each card shows the actual matched field. Other contact fields are not requested.

400: check the input. 401: reconnect. 403: check permissions and resource access. 429: wait for Retry-After. 503: unavailable; this is not an empty result. Nothing is retried automatically. Searching does not change residents or send messages.

Opening eVaskeri requires Nortec, Users2, User Read and Create, whole-bank access and an active resident with a laundry location. It opens the resident’s full account, where resident actions are possible. The legacy login link can be reused for up to 10 days; Portal logout does not revoke it. The example opens it immediately without storing or displaying it. A blocked popup creates no link. 404 means missing/deleted resident, 409 no active location, and 501 unsupported tenant.