Reports API Version 2 Goals
Introduction
Goals are groups of triggers that have matched some business criteria based on rules.
- Each Goal is given a numeric ID which can be used to reference it in the APIs.
- A Trigger can be marked with a single Goal ID.
- Each Goal can be configured with 1 or more Goal Ranges which specify which triggers should be marked as this Goal.
- Goals contain rules that are activated for a given date range.
- A Goal ID of 0 is used to indicate a trigger has no Goal.
- Goals can be assigned an order number and are actioned in ascending order.
Goal Properties
These are the properties that can be accessed using the API.
- goalId (int) - Goal ID
- igrp (int) - IGRP ID
- goalTitle (string) - The goal name
- goalDescription (string) - A description of the goal
- goalStatus (int) - Infinity Status code indicating status of goal (E.g. 200)
- deDupeFields (array) - An array of comma delimited values.
- deDupeLookback (integer) - An integer with the number of days deduplication is applied.
- actionConfig (array) - The actions for this goal
- criteriaConfig (array) - The criteria for this goal
List Goals
Lists the goals for an IGRP.
Request:
GET /reports/v2/igrps/{IGRP SPECIFIER}/goals
URL Path Params
- IGRP SPECIFIER (int) - Installation ID.
GET Params
- filter (array) OPTIONAL - One or more filters.
- sort (array) OPTIONAL - One or more sorting params.
- limit (integer) OPTIONAL - Limit on the result set.
- offset (integer) OPTIONAL - Offset of the result set.
Filter and Sort Fields
- goalId (int) - Goal ID
- goalTitle (string) - The goal name
- goalStatus (int) - Infinity Status code indicating status of goal (E.g. 200)
Response:
HTTP 200 - OK