Fieldmotion API Getting started

Asset maintenance

List asset maintenance IDs

POST /a/AssetMaintenances_list

List every asset maintenance record ID in the authenticated tenant.

When to use this endpoint

Use AssetMaintenances_list only as a lightweight ID inventory before requesting detail elsewhere. It carries no schedule, asset, or active-state information.

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

This endpoint has no operation-specific parameters.

Example request

$ids = FM_api('AssetMaintenances_list');

Example response

[
  {"id": "61003"},
  {"id": "61004"}
]

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.

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

Behaviour and edge cases

  • All maintenance rows are included, including inactive records and records whose asset or recurrence is missing.
  • There is no ordering, filtering, pagination, or row limit.

See it in Fieldmotion

CRM1

No production CRM1 caller was found; CRM1 uses AssetMaintenance_getDT for its maintenance list.

CRM2

No production CRM2 caller was found; CRM2 lists asset-scoped recurrences through the recurrence API.

Related endpoints