Fieldmotion API Getting started

Forms

Query mapped form blocks

POST /a/FormBlocks_getDataTable

Query selected block fields through the shared mapped table engine.

When to use this endpoint

Use this only for an internal mapped-table integration. No current CRM1 or CRM2 production caller was found; the visible block grids use FormBlocks_getDT.

Authentication and permissions

The request must authenticate with signed API-key fields or a logged-in CRM session and is scoped to the authenticated tenant.

The handler performs no form, department, owner, or page-permission check unless the page below says otherwise. CRM navigation may impose additional UI-only access rules.

Parameters

ParameterTypeRequiredDescription
fieldsNative arrayYesMapped fields to return: id, type, name, image, code, parent, cDate, and lastEdited. Unknown names are ignored.
typeInteger-compatibleNoExact integer-coerced block type comparison.
isTable / draw / start / length / limitInteger-compatibleNoShared table controls. Table mode defaults to offset 0 and length 10; exact isTable=0 returns an unwrapped data set and uses a positive limit when supplied.
orderBy / orderDesc or order[0]Mapped field / DataTables orderNoShared mapped ordering controls.
searchValue / searchFieldString / field or native arrayNoShared case-insensitive substring search across selected mapped fields.
Mapped filters / referenceDate / dateFrom / dateTo / advanceSearch / groupByMixedNoShared mapped filters and tenant-timezone date controls. Raw advanced conditions are trusted-CRM-only.

Example request

$table = FM_api('FormBlocks_getDataTable', [
	'fields' => ['id', 'name', 'image', 'lastEdited'],
	'type' => '1',
	'draw' => '1',
	'start' => '0',
	'length' => '25',
]);

Example response

{
  "data": [{"id": "4822", "name": "Standard footer", "image": null, "lastEdited": "1790845200"}],
  "draw": 1,
  "recordsTotal": "18",
  "recordsFiltered": "6"
}

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: fields"}Fields are absent.

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

Behaviour and edge cases

  • Table mode returns data, draw, tenant-wide recordsTotal, and filtered count. Non-table mode returns the data array directly.
  • The table has no soft-delete column, so every stored row of the exact requested type is eligible.

See it in Fieldmotion

CRM1

No production CRM1 caller was found.

CRM2

No production CRM2 caller was found.

Related endpoints