List Event Fields
Function name:m3ter_ListEventFields
Category: READ
HTTP method: GET
Destination: m3ter
List Event Fields.
Retrieves a list of Fields for a specific Event Type. These Fields are dynamic and forward compatibile, enabling calculation operations on the Event schema.
Notes:
- In many of the Response schema for this call, such as when you retrieve the Fields for a
configuration.commitment.createdEvent Type,newrepresents the attributes the newly created object has. The Response to a call to retrieve the Fields for aconfiguration.commitment.updatedEvent Type will contain Field values for both theoldandnewobjects. The Response to a call to retrieve the Fields for aconfiguration.commitment.deletedEvent Type will only containoldFields, for values at point of deletion. Having access to reference bothnewandoldField values for an object can be very useful if you want to base a Notification rule on an Event and include a calculation in the rule that, for example, comparesnewvalues withold- for example, trigger a Notification only when a Commitment has been updated and thenewvalue for theamountis at least $1,000 greater than theoldvalue. - Some Event types will show
customFieldseven though the specific billing or configuration object the Event is for does not yet have the custom fields functionality implemented. For these Events, theircustomFieldsvalues will not be populated until such time as the custom fields functionality is implemented for them
Parameters
Exits
Retrieve EventResponse
Function name:m3ter_GetEvent
Category: READ
HTTP method: GET
Destination: m3ter
Retrieve a specific Event.
Retrieves detailed information about the specific Event with the given UUID. An Event corresponds to a unique instance of a state change within the system, classified under a specific Event Type.
Parameters
Exits
List EventResponse
Function name:m3ter_ListEvents
Category: READ
HTTP method: GET (paginated)
Destination: m3ter
List all Events.
Retrieve a list of all Events, with options to filter the returned list based on various criteria. Each Event represents a unique instance of a state change within the system, classified under a specific kind of Event.
NOTES: You can:
- Use
eventNameas a valid Query parameter to filter the list of Events returned. For example:.../organizations/{orgId}/events?eventName=configuration.commitment.created - Use the List Notification Events endpoint in this section. The response lists the valid Query parameters.
Parameters
Exits
List Notification Events
Function name:m3ter_ListEventTypes
Category: READ
HTTP method: GET
Destination: m3ter
Retrieve a list of Notification Event Types.
This endpoint retrieves a list of Event Types that can have Notification rules configured.