Skip to content

API Documentation

ConceptsThe Worklayer platformAuthenticationRate Limits

MemberThe Member ResourceCreate a memberRetrieve a memberRetrieve a member by external IDRetrieve a list of membersUpdate a memberAccept terms for 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 jobRequest cancellationRequest reopen

Job ProgressionsApprove a draftReject a draftMark job as ready to file

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 ResourceList dependent profilesRetrieve a dependent profileCreate a dependent profileUpdate a dependent profileDelist a dependent profileProvide a dependent profile to a jobRemove a dependent profile from a jobRetrieve dependent profiles for a job

Business ProfilesThe Business Profile ResourceList business profilesCreate a business profileUpdate a business profileRetrieve a business profileRetrieve a business profile for a jobDelist a business profileProvide a business profile to a job

Tax Refund MethodsThe Tax Refund Method ResourceList tax refund methodsCreate a tax refund methodRetrieve a tax refund methodRetrieve a tax refund method for a jobUpdate a tax refund methodDelist 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

MessagesThe Message ResourceSend a messageList messagesGet unread count

OCRStart OCR processingGet OCR results

WebhooksConsume webhook eventsEvent resourcesCheck signatures

Magic LinkDashboardJob DetailsWaitlist

PortalPortal embedding

GuidesFilteringPostman Collection

Listing Documents

List documents belonging to your job.

The list documents endpoint allows you to retrieve a paginated list of documents in your job.

Endpoint

Method	Url
`GET`	`/v1.0/jobs/{job_id}/documents`

Request Parameters

page_size

•

number

The page size for search result pagination. If not provided, the service will default to 50 items.

page_token

•

string

The page to fetch. If any, this would be the next_page_token value returned from the previous request.

Sample Request

Copied
1curl -X GET 'https://api.worklayer.com/v1.0/jobs/a9749189-c82b-488b-a448-8f74c3d254e0/documents' \
2-H 'Authorization: Bearer {token}'

Response

data

•

list

The documents belonging to that job. Each document includes a document_type field containing the type of document (or null if no type was specified). See the document reference page and document types for more information.

next_page_token

•

string

The pagination token to retrieve the next page of results. If the value is "", it means no further results for the request.

Sample Response

Copied
1{
2  "data": [
3    {
4      "id": "e00c724c-86b1-4431-b906-3ca7158bfe66",
5      "title": "2025-IRS-1098.pdf",
6      "description": "",
7      "create_time": "2022-10-11T17:26:14.639Z",
8      "update_time": "2022-10-11T17:26:14.665Z",
9      "document_type": {
10        "id": "1098",
11        "name": "1098"
12      }
13    },
14    {
15      "id": "f0601d84-b930-4d54-8221-9ba291d7c3b4",
16      "title": "drivers-license.jpg",
17      "description": "",
18      "create_time": "2022-10-07T17:19:57.447Z",
19      "update_time": "2022-10-07T17:21:06.105Z",
20      "document_type": {
21        "id": "ID",
22        "name": "Identification"
23      }
24    }
25  ],
26  "next_page_token": "ZGF0ZS9kYXRlX2NyZWF0ZWQvZGVzYy8xNjY1MTYzMTk3NDQ3"
27}

Errors

Forbidden: API Client cannot list documents.
Unauthorized: API Client does not have valid credentials.
BadRequest: There was a malformed request.

Last updated on February 2, 2026

Privacy Policy Terms & Conditions© 2026 Taxfyle