SmartMatchApp

List Task Notes

Retrieve all notes associated with a specific task, ordered by date descending.

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/tasks/<task_id>/notes/" \
    -u <token>: \
    -X GET
Example Success Response:
{
    "objects": [
        {
            "id": 5,
            "body": "<p>Client confirmed the meeting for next Friday.</p>",
            "date": "2026-02-20T14:30:00+00:00",
            "agency_user_id": 3,
            "created_date": "2026-02-20T14:30:00+00:00"
        },
        {
            "id": 4,
            "body": "<p>Left a voicemail. Will follow up tomorrow.</p>",
            "date": "2026-02-18T10:00:00+00:00",
            "agency_user_id": 3,
            "created_date": "2026-02-18T10:00:00+00:00"
        }
    ]
}

body may contain HTML. agency_user_id is the ID of the agency user who created the note.

Base Request:

Method: GET

Authentication: Basic Authentication. Requires a valid <token> passed.

Rate Limits:

30 requests within 5 seconds

Error Responses:
401 Unauthorized

This error occurs when the <token> is missing, invalid, or the API access is disabled.

Possible errors: "not authenticated" or "token is disabled" or "Agency API is disabled"
404 Not Found

This error occurs if the task with the specified ID does not exist.
Possible errors: "object does not exist"
405 Method Not Allowed

This error occurs if an HTTP method other than GET is used.
Possible errors: "wrong method"
429 Too Many Requests

This error occurs when the client has sent too many requests in a given amount of time, leading to rate limiting by the server.

Possible errors: "too many requests"
500 Server Error

Possible errors: "Internal server error"