Skip to content

API Documentation

ConceptsThe Worklayer platformAuthentication

MemberThe Member ResourceCreate a memberRetrieve a list of membersUpdate a member

JobsThe Job ResourceThe job creation flowThe Info Gathering ChecklistCreate a job from a templateRetrieve questionnaireSubmit questionnaire answersRequest a specific ProRequest a previous ProSubmit a jobRetrieve a list of your jobsList job documentsDelete a jobRetrieve a job checklistComplete info gathering for a job

ConsultationsThe Consultation Resource

Scope Change RequestsChange job scopeList consultation service itemsCreate job scope change requestApprove a job scope changeReject a job scope change

Job TemplatesThe Job Template ResourceRetrieve available job templates

Personal ProfilesThe Personal Profile ResourceRetrieve a personal profileSave a personal profileProvide a personal profile to a jobRetrieve a personal profile for a job

Spousal ProfilesThe Spousal Profile ResourceRetrieve a spousal profileSave a spousal profileProvide a spousal profile to a jobRetrieve a spousal profile for a job

Dependent ProfilesThe Dependent Profile ResourceRetrieve a dependent profileCreate a dependent profileUpdate a dependent profileProvide a dependent profile to a jobRemove a dependent profile from a jobRetrieve dependent profiles for a job

Business ProfilesThe Business Profile ResourceCreate a business profileUpdate a business profileRetrieve a business profileRetrieve a business profile for a jobProvide a business profile to a job

Tax Refund MethodsThe Tax Refund Method ResourceCreate a tax refund methodRetrieve a tax refund methodRetrieve a tax refund method for a jobUpdate a tax refund methodProvide a personal refund methodProvide a business refund method

DocumentsThe Document ResourceCreate a documentGet a documentDownload a document

Document TypesThe Document Type ResourceList document types

WebhooksConsume webhook eventsEvent resourcesCheck signatures

Magic LinkDashboardJob Details

GuidesFilteringPostman Collection

Questionnaire Answers

Submit answers to required questions from the questionnaire.

The questionnaire answers endpoint lets you provide answers to questions specified by the Questionnaire.

Endpoint

Method	Url
`PUT`	`/v1.0/jobs/{job_id}/questionnaire/answers`

Note

This endpoint follows PUT semantics, meaning you should always send the full set of answers for all questions as they'll be overridden every time

Url Parameters

job_id

•

guid

The job's ID.

Request Payload

answers

•

object

An object mapping question IDs to answers as specified in the Questionnaire questions field.

Type	Answer Format
`BOOL`	A boolean; either `true` or `false`
`NUMERIC`	A number; e.g `23`
`TEXT`	A string; e.g. `"Hello world"`
`DATE_TIME`	A string of a timestamp; e.g `"2022-11-04T04:00:00.000Z"`
`SINGLE_SELECT`	An id from the provide `options`; e.g.`"OPTION1"`
`MULTI_SELECT`	An array of ids from the provide `options`; e.g. `[“OPTION1”, "OPTION2"]`

Sample Request

Copied
1curl -X PUT 'https://api.worklayer.com/v1.0/jobs/{job_id}/questionnaire/answers' \
2-H 'Authorization: Bearer {token}'
3-H 'Content-Type: application/json' \
4-H 'Accept: application/json' \
5-d '
6{
7    "answers": {
8        "QUESTION_1": true,
9        "QUESTION_2": 10,
10        "QUESTION_3": "Hello World",
11        "QUESTION_4": "2022-11-04T04:00:00.000Z",
12        "QUESTION_5": "OPTION1",
13        "QUESTION_6": ["OPTION1", "OPTION2"]
14    }
15}'

Response

ready_to_submit

•

boolean

Signals whether or not all required answers have been provided for a valid path in the questionnaire for the job to be submitted to the pool of Tax Pros.

update_time

When the answers were updated. A timestamp in format 2021-04-28T13:45:25.781Z.

Sample Response

Copied
1{
2    "ready_to_submit": true,
3    "update_time": "2021-04-28T13:52:27.379Z"
4}

Next steps

Submit job

Last updated on April 16, 2025

Privacy Policy Terms & Conditions© 2025 Taxfyle