1. Survey
Game Loom
  • Game Loom
    • 👋 Welcome to Game Loom
  • Getting started
    • Introduction
    • 👤 Authentication
  • User Registration
    • Introduction
    • Get Countries
      GET
    • Get Cities
      GET
    • Single user registration
      POST
    • Bulk Register Users
      POST
  • Notifications
    • Overview
    • Receiving Event Notifications via Webhooks
    • Get All notifications for specific user
      GET
  • Rewards
    • Overview
    • Points
      • Record user point event
      • Get user points
      • Get Specific user point
    • Levels
      • Record user level event
      • Get user levels
      • Get Specific user level
    • Badges
      • Award badge to user
      • Get user badges
      • Get Specific user badge
  • Challenges (Gamification elements)
    • Introduction
    • Leaderboard
      • Get available leaderboards for user
      • Submit score to a leaderboard
      • Get user's leaderboard participation history
      • Get leaderboard details
      • Get leaderboard ranking
      • Get user's record for a leaderboard
      • Get user's entry history for a leaderboard
    • Survey
      • Overview
      • Get available surveys for user
        GET
      • Start a new survey participation
        POST
      • Get detailed user participation
        GET
      • Get user's survey participation history
        GET
      • Abandon survey participation
        DELETE
      • Save individual answer to survey question
        POST
      • Submit completed survey
        PUT
      • Submit Survey with answers (One-Step Submission)
        POST
    • Quiz
      • Get available quizzes for user
      • Submit complete quiz answers
      • Get comprehensive user quiz history
      • Get comprehensive quiz attempt details
    • Open Challenge
      • Overview
      • Get available open challenges for user
      • Complete an open challenge
      • Get user's open challenge participation history
      • Get user open challenge by ID
    • Schemas
      • Survey Schame
  1. Survey

Submit Survey with answers (One-Step Submission)

POST
api/v1/user/{userkey}/surveys/{surveyId}/submit

Submit Survey (One-Step Submission)#

Submits all answers for a survey in a single request, automatically creating the participation, validating responses, completing the survey, and processing rewards.
Unlike the progressive survey flow, this endpoint does not require calling Start a new survey participation beforehand.
Participation is created implicitly, all answers are submitted at once, and the survey is immediately marked as Completed.
This endpoint is ideal for:
Instant-response surveys
Form-like submissions
Scenarios where step-by-step user progression tracking is not required

When to Use This Endpoint#

Use this endpoint when:
You want a single-call submission flow
You do not need granular progress or abandonment analysis
Immediate completion and reward distribution is required
For surveys that require progress tracking, partial answers, or abandonment handling, use the progressive survey endpoints instead.

Path Parameters#

NameRequiredTypeDescription
surveyId✅ YesUUIDUnique identifier of the survey to submit

Answer Validation Rules#

Validation is automatically applied based on the question type:
Text / OpenEnded
Any non-empty string
YesNo
Accepted values: "yes", "no", "true", "false" (case-insensitive)
MultipleChoice
The answer must exactly match one of the values defined in the choices field
localizedChoices are not used for validation and are intended for display purposes only
Important
When submitting answers for multiple-choice questions, always send the canonical value from the choices field, not the localized label.

Validation Rules#

The system enforces the following validations:
All survey questions must have corresponding answers
Survey must be active and within its configured date range
User must not have already submitted this survey
Answers must match the question type requirements
User must meet targeting criteria, if configured

Response#

The response includes:
Submission confirmation with a unique participation ID
Submission and completion timestamps
All submitted answers mapped to their questions
Reward details (if applicable)

Error Scenarios#

Error CodeDescription
SUBMISSION_ALREADY_EXISTSUser has already submitted this survey
CHALLENGE_NOT_AVAILABLESurvey is inactive or outside its date range
ALL_QUESTIONS_MUST_BE_ANSWEREDMissing answers for one or more required questions
CHALLENGE_NOT_FOUNDSurvey does not exist or user lacks access
USER_NOT_ELIGIBLE_FOR_SURVEYUser does not match targeting criteria

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api-stg.98s.studio/api/v1/user/{{user-key}}/surveys/af1af60e-8966-4750-a4b8-c0450efd0d9f/submit' \
--header 'x-api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "answers": [
        {
            "questionId": "8e0c1359-28e8-410b-92f1-7c20e0cd4e2b",
            "answer": "Very satisfied"
        },
        {
            "questionId": "f5873679-f63c-4efc-a9b8-2d35d4d792f5",
            "answer": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
        },
        {
            "questionId": "20e7085b-5069-4dfe-a3dc-6f08e59c5812",
            "answer": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur eget faucibus diam"
        }
    ]
}'
Response Response Example
{
    "id": "fc3d2718-ab74-422c-a2b5-7329c5f98c5a",
    "surveyId": "af1af60e-8966-4750-a4b8-c0450efd0d9f",
    "userKey": "1765132434113",
    "submissionDate": "2025-12-23T22:04:19.1309681Z",
    "answers": [
        {
            "questionId": "8e0c1359-28e8-410b-92f1-7c20e0cd4e2b",
            "question": "How satisfied are you with our app?",
            "userAnswer": "Very satisfied"
        },
        {
            "questionId": "f5873679-f63c-4efc-a9b8-2d35d4d792f5",
            "question": "Would you recommend our app to others?",
            "userAnswer": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
        },
        {
            "questionId": "20e7085b-5069-4dfe-a3dc-6f08e59c5812",
            "question": "What features would you like to see in future updates?",
            "userAnswer": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur eget faucibus diam"
        }
    ]
}
Modified at 2025-12-23 22:05:18
Previous
Submit completed survey
Next
Get available quizzes for user
Built with