FAQ — Mobile App and Researcher Users
Frequently asked questions for researchers and field users accessing Survanta via the mobile app.
Q: How do I log in to the mobile app?
The client posts email/password credentials to POST /api/mobile/auth/login. Mobile JWT login supports an active TenantUser; it does not authenticate Website-only or Platform accounts. A new user can instead validate and consume a one-time tenant invitation through the mobile invitation endpoints, then sign in.
Q: What is a JWT token and do I need to worry about it?
A JWT is the bearer credential returned by mobile login. The client must store it appropriately, send Authorization: Bearer <token> to protected mobile endpoints, and stop using it at ExpiresAtUtc. The server exposes no refresh-token, silent-refresh, logout, or revocation endpoint. Integration clients use a different API-key scheme.
Q: How do I see my assigned tasks?
Call GET /api/mobile/tasks with the mobile JWT and TenantViewAssignedTasks. Optional filters are fromDate, toDate, isDone, page, and pageSize. The endpoint lists only tasks assigned to the current active tenant user; it does not provide a task-acceptance/In-Progress transition.
Q: How do I complete a survey?
Load an allowed active survey from GET /api/mobile/surveys/{surveyId} and submit to POST /api/mobile/surveys/{surveyId}/submissions. Include a stable ClientSubmissionId so a recognized retry returns the previously accepted instance. The mobile API does not expose a separate draft-save/resume endpoint.
Q: How do I scan a QR code to access a survey?
QR scanning is a client UI concern. After extracting the raw token, call POST /api/mobile/public/resolve-token with the token and optional passcode. The server resolves only SingleSurvey or TenantActiveSurveys access and returns public-safe survey/portal metadata; invalid tokens are not treated as authenticated mobile assignments.
Q: What if I forget my password?
The mobile surface currently provides POST /api/Researcher/forgot-password to request a confirmation code and POST /api/Researcher/confirm-code to validate it. It does not expose a mobile endpoint that sets a new password, so do not present this as a complete reset-link flow. Use an available supported account-recovery channel after code confirmation.
Q: Can I complete surveys offline?
The documented mobile API is online: it does not expose offline survey-package download, queued local submission synchronization, or conflict-resolution contracts. A client may retry an online submission safely with the same ClientSubmissionId, but that idempotency support is not an offline mode.
Q: Who do I contact if I have problems with the app?
Contact your Tenant Admin for account status, permissions, invitation, task assignment, or tenant subscription issues. The current tenant/mobile controllers do not guarantee a Tenant Admin password-reset action; use the supported account-recovery/support channel for password changes. Technical API issues can be escalated to the Platform team.