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 ResourceRetrieve a job by short IDThe job creation flowThe Info Gathering ChecklistCreate a job from a templateRetrieve questionnaireSubmit questionnaire answersRequest a specific ProRequest a previous ProAssign a supporting clientRemove a supporting clientSubmit a jobRetrieve a list of your jobsList job documentsDelete a jobRetrieve a job checklistComplete info gathering for a jobRequest cancellationRequest reopen

Relationship ManagerRelationship Manager ResourceRetrieve a job relationship manager

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 NotesThe Job Note ResourceCreate a job noteGet a job noteList job notes

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 documentDelete 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 Job Notes

List the notes belonging to a job in your workspace.

The list job notes endpoint allows you to retrieve a paginated list of the job notes for a job in your workspace.

By default, notes are returned from newest to oldest.

Endpoint

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

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.

order_by

•

string

The order in which to return results, in the format {field} {direction} — for example, create_time asc. Only the create_time field is supported. Defaults to create_time desc (newest first).

Sample Request

bashCopied
1curl -X GET 'https://api.worklayer.com/v1.0/jobs/a439ddfa-6ba4-4b38-8cf0-5d09db1a0af4/notes' \
2-H 'Authorization: Bearer {token}'

Response

data

•

list

The notes belonging to that job. See the job note resource page.

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

jsonCopied
1{
2  "data": [
3    {
4      "id": "873eb165-3a9f-443d-b273-b72a1d9fa2da",
5      "job_id": "a439ddfa-6ba4-4b38-8cf0-5d09db1a0af4",
6      "body": "Client uploaded the missing W-2. Ready for review.",
7      "created_by_user_id": "a6e5ea2f-7d96-4852-9f46-2383dfd572f7",
8      "recipient_user_ids": ["95e6f305-913e-40ad-9c80-ede263670878"],
9      "create_time": "2026-08-06T13:45:25.781Z"
10    },
11    {
12      "id": "dd313afe-8348-4f25-b327-1faf2244710a",
13      "job_id": "a439ddfa-6ba4-4b38-8cf0-5d09db1a0af4",
14      "body": "Waiting on the client's prior-year return.",
15      "created_by_user_id": "781350c1-14cd-4790-88ef-841af4097aad",
16      "recipient_user_ids": [],
17      "create_time": "2026-08-04T17:49:00.223Z"
18    }
19  ],
20  "next_page_token": "c3RyaW5nL3dvcmtzcGFjZV9tZW1iZXIudXNlcl9pZC9hc2MvbG9jYWwlN0NlMmNlMTM0ZC03NmYyLTVhNzctOWQ2Yy05MDY2NjVkM2VlNTQ="
21}

Errors

Forbidden: API Client cannot view the job's notes.
Unauthorized: API Client does not have valid credentials.
BadRequest: Either the pagination options are in an incorrect format, or there was a malformed request.
NotFound: The job was not found.

Last updated on August 6, 2026

Privacy Policy Terms & Conditions© 2026 Taxfyle