---
title: "Submit eligibility questionnaire"
method: POST
path: "/v1/contractors/eligibility-questionnaire"
tags: ["Eligibility"]
---

# Submit eligibility questionnaire

`POST /v1/contractors/eligibility-questionnaire`

Submits an eligibility questionnaire for a contractor employment.

The questionnaire determines if the contractor is eligible for certain products or features.
The responses are validated against the JSON schema for the questionnaire type.

**Requirements:**
- Employment must be of type `contractor`
- Employment must be in `created` status
- Responses must conform to the questionnaire JSON schema


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage employments (`employments`) | - | Manage employments (`employment:write`) |

## Query parameters

- `json_schema_version` union
  - integer — Specific version number
  - 'latest' — Use latest version

## Request body

- SubmitEligibilityQuestionnaireRequest — Request body for submitting an eligibility questionnaire
  - `employment_slug` string, uuid, required — The slug/ID of the employment
  - `responses` object, required — Responses to the questionnaire questions
  - `type` 'contractor_of_record', required

## Response `201`

Questionnaire submitted successfully

- EligibilityQuestionnaireResponse
  - `data` EligibilityQuestionnaire, required
    - `is_blocking` boolean, required — Whether the questionnaire blocks further progress if failed
    - `questions` object, required — The questions in the questionnaire
    - `responses` object, required — The responses to the questionnaire
    - `slug` string, uuid, required — Identifier of the employment being terminated.
    - `submitted_at` string, datetime, required — UTC date time in YYYY-MM-DDTHH:mm:ss format
    - `type` 'contractor_of_record', required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)