maton salesforce record list

maton salesforce record list [flags]

List records in one of two modes:

Time-window mode (default) — record IDs updated or deleted within a window. Maps to GET /sobjects/{type}/updated or /sobjects/{type}/deleted. Requires –type, –start, –end (ISO-8601/RFC3339). Window must be at most 30 days; –start cannot be more than 30 days in the past for –changes=deleted.

Recent mode (–recent) — records recently viewed by the connected user. Maps to GET /recent. Accepts –limit; ignores –type/–start/–end/–changes.

Options

--changes <string> (default "updated")
Time-window mode: which change set to return ("updated" or "deleted")
--connection <string>
Connection ID to route through (Maton-Connection header)
--dry-run
Print the request that would be sent without executing it
--end <string>
Window end (time-window mode, ISO-8601)
-q, --jq <expression>
Filter JSON output using a jq expression
--json
Output raw JSON
-L, --limit <int> (default 0)
Recent mode: max results
--paginate
Follow next_cursor and concatenate all pages (list commands only)
--recent
List recently viewed records (GET /recent) instead of a time window
--start <string>
Window start (time-window mode, ISO-8601)
-t, --template <string>
Format JSON output using a Go template; see "maton help formatting"
--type <string>
sObject type (time-window mode, e.g. Contact, Account)

Options inherited from parent commands

-p, --profile <string>
Profile to use for this invocation (overrides the active profile; also reads MATON_PROFILE)

Examples

$ maton salesforce record list --type Contact --start 2026-04-01T00:00:00Z --end 2026-05-01T00:00:00Z
$ maton salesforce record list --type Contact --start 2026-04-01T00:00:00Z --end 2026-05-01T00:00:00Z --changes deleted
$ maton salesforce record list --recent
$ maton salesforce record list --recent --limit 25

See also