Save carrier-question responses

curl -X PUT https://api.vitablehealth.com/v1/enrollments/enrl_AAAAAAAAAAAAAAAAAAAAAQ/carrier-question-responses \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "expected_revision": 1,
  "responses": [
    {
      "answer": "string",
      "question_id": "string",
      "applicant_id": "string"
    }
  ]
}'

{
  "data": {
    "enrollment_id": "string",
    "selected_plan_hios_id": "string",
    "revision": 1,
    "responses": [
      {
        "question_id": "string",
        "applicant_id": "string",
        "answer": "string"
      }
    ],
    "updated_at": "2024-01-15T09:30:00Z",
    "finalized_at": "2024-01-15T09:30:00Z",
    "reviewed_revision": 1,
    "questions": [
      {
        "question_id": "string",
        "applicant_id": "string",
        "type": "boolean",
        "label": "string",
        "required": true,
        "content": [
          "string"
        ],
        "options": [
          {
            "value": "string",
            "label": "string"
          }
        ],
        "conditions": [
          {
            "question_id": "string",
            "value": "string"
          }
        ],
        "requires_agreement": true,
        "earliest_date": "2023-01-15",
        "latest_date": "2023-01-15",
        "blocking_reason": "string"
      }
    ],
    "blocked_reasons": [
      "string"
    ],
    "initial_responses": [
      {
        "question_id": "string",
        "applicant_id": "string",
        "answer": "string"
      }
    ]
  }
}

Replaces the saved carrier-question responses for the selected enrollment plan.

Authentication

AuthorizationBearer

API Key or Access Token authentication using Bearer token in Authorization header. API keys use the vit_apk_ prefix, access tokens use the vit_at_ prefix.

Path parameters

enrollment_idstringRequired

Unique enrollment identifier (enrl_*)

Headers

X-Vitable-OrganizationstringOptional

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`.

Request

This endpoint expects an object.

expected_revisionintegerRequired>=1

responseslist of objectsRequired

Response headers

X-RateLimit-Limitinteger

Maximum number of requests allowed within the rate limit window

X-RateLimit-Remaininginteger

Number of requests remaining in the current rate limit window

X-RateLimit-Resetinteger

Unix timestamp (seconds) when the rate limit window resets

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error