Skip to main content

band customer-profile history list

List a customer profile's versions

Synopsis​

Lists every recorded version of a customer profile, newest first. Always returns an array.

Each entry nests the profile snapshot under "data" and audit fields under "metadata" — the version number is at metadata.version, not top-level the way it is on 'customer-profile get'. Observed metadata.operation values are CREATED, UPDATED, and DELETED.

band customer-profile history list <profile-id> [flags]

Examples​

band customer-profile history list 3IIzIFnRRQBE3AMzPpMTNo --plain
# [{"data":{"id":"...","name":"Acme"},"metadata":{"version":2,"operation":"UPDATED","userName":"...","createdDate":"..."}}, ...]

Options​

--all Fetch every page (cannot be combined with --offset)
-h, --help help for list
--limit int Page size (default 50)
--offset int Pagination offset

Options inherited from parent commands​

--account-id string Bandwidth account ID (overrides config)
--environment string API environment: prod, test (overrides config)
--format string Output format: json or table (default "json")
--plain Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO​