---
title: "Submit checklist responses in bulk"
method: POST
path: "/checklists/ChecklistResponse/bulk"
tags: ["CheckLists"]
---

# Submit checklist responses in bulk

`POST /checklists/ChecklistResponse/bulk`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/checklists/ChecklistResponse/bulk`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/checklists/ChecklistResponse/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ServiceChannelServicesWebApiModelsRequestChecklistsChecklistResponsesCreateBulkChecklistResponseRequest[]
  - `AssetIds` integer[]: List of asset identifiers to be associated with the checklist responses
  - `Attachments` ServiceChannelServicesWebApiModelsRequestChecklistsChecklistResponsesAttachmentInfo[]: List of attachment information to be added to the checklist responses
    - `DocumentName` string: The name of the document.
    - `DocumentPath` string: Document path in the storage.
  - `CheckListResponseRequest` ServiceChannelServicesWebApiModelsRequestChecklistsChecklistResponsesCheckListResponseRequest, required
    - `CheckListQuestionId` integer, required
    - `ChecklistQuestionOptionIds` integer[]
    - `CheckListQuestionOptionID` integer, required
    - `Answer` string
    - `FreeTextAnswer` string
    - `EntityId` integer, required
    - `EntityTypeId` integer
    - `ProviderId` integer
    - `Attempt` integer
    - `TechnicianId` integer
    - `AuthUserId` integer

## Response `201`

Responses to a checklist question are created. List of checklist response identifiers is returned.

- integer[]

## Other responses

- `400`: The request is not accepted due to bad syntax, missing parameters, insufficient data, etc. <br/>Error codes: 502 — Work order is not found 503 — Not all required parameters were specified 503 — The FreeTextAnswer is required 503 — The picture is required 503 — Checkbox responses only support next values: on, off, 1, 0, true, false, yes, no 503 — The required URL view acknowledgement checkbox only supports the next values: on, 1, true, yes 503 — Multiple answers are not allowed to a non-selector type question. 503 — Multiple answer is not allowed to selector type question where AllowMultiSelect is disabled 503 — The active checklist with specified question (questionId: #) for the specified work order (workOrderId: #) is not found 503 — Asset ids are not allowed for the checklist which is not displayed for each asset 503 — AssetIds are required for this checklist question 503 — Not all assets are associated with the work order. Assets not associated with the work order: {#} 503 — Assets not found (asset ids: {#}) 503 — Not all types of specified assets match the asset types specified for the checklist question. Assets with wrong types: {#} 503 — There are no checklists for the specified work order. WorkOrderId: {#} 503 — Question (id: {#}) was not found 503 — Checklist responses should be specified for the same work order 503 — Checklist responses should be specified for the same attempt. 503 — The Answer is invalid. It must be a number or a string representing a number 503 — The question has already been answered for this attempt number. QuestionId: {#}.
- `401`: The request is not authorized. <br/>Error codes: 504 — API call rejected by security permissions
- `500`: The server was unable to complete the request due to an internal error.

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)