Fieldmotion API Getting started

Customers

Retrieve customer notes

POST /a/Customer_getNotes

Retrieve the raw notes value stored on one customer.

When to use this endpoint

Use Customer_getNotes before displaying or replacing customer notes in a focused notes workflow.

CRM1 sometimes stores an encoded array of note objects and sometimes legacy plain text. This endpoint does not distinguish or decode those forms.

Authentication and permissions

The request must authenticate with signed API-key fields or a logged-in CRM session. The handler performs no additional page or role-permission check.

The lookup and any write use the authenticated tenant; an ID from another tenant cannot be addressed through this call.

Parameters

ParameterTypeRequiredDescription
idInteger stringYesCustomer to read; it must convert to a positive integer.

Example request

$result = FM_api('Customer_getNotes', [
	'id' => '1088',
]);

Example response

{
  "notes": "[{\"content\":\"Gate code confirmed\",\"noteTime\":1727172000}]"
}

Encoded notes remain a string rather than becoming a nested JSON value. A legacy SQL NULL is returned as JSON null.

Errors and unusual responses

ResponseCondition
{"error":"not logged in"}No authenticated tenant context is available. Invalid signed credentials can be rejected by the dispatcher before the handler runs.
{"error":"missing or invalid parameter: id"}id is absent or invalid.
falseNo matching customer row exists; the handler returns the database false value rather than a named error.

Legacy application errors may be returned with HTTP 200. Check the decoded response for error, not only the HTTP status.

Behaviour and edge cases

  • The lookup does not filter inactive or soft-deleted customers.
  • No JSON validation, ordering, or note-level filtering occurs.
  • This is a single-record read with no pagination.

See it in Fieldmotion

CRM1

Click a Notes cell on the legacy Customers table, or open the Customer Notes tab on a job. Filter Network requests for Customer_getNotes; CRM1 decodes values beginning with [ as its structured note list.

CRM2

No direct production CRM2 caller was found. CRM2 customer forms use their broader data contracts.

Related endpoints