# Get usage trends for specified item type

POST /v3/usage/{itemType}/trends

Endpoint: POST /v3/usage/{itemType}/trends
Security: API_Key

## Path parameters:

  - `itemType` (string, required)
    Enum: "AUDIT", "WEB_JOURNEY"

## Request fields (application/json):

  - `dataSources` (array)
    Non-empty array of data sources. Usage for selected data sources only will be shown
    Example: [107239]

  - `dataSourceCreators` (array)
    Non-empty array of user IDs. Matches data sources that have been created by any of the specified users
    Example: [123]

  - `dataSourceFolders` (array)
    non-empty array of folders with domains (subfolders), items from which will be included in response

  - `dataSourceFolders.folderId` (integer, required)
    ID of a folder
    Example: 123

  - `dataSourceFolders.domains` (array)
    null or empty array of domains (subfolders) present on an item, works as "null or empty if entire folder (all domains in a folder), otherwise specific domain IDs"
    Example: [123]

  - `dataSourceLabels` (array)
    Non-empty array of labels present on an item. Matches data sources that have all specified labels

  - `runFrequencies` (array)
    Non-empty array of frequency names. Matches data sources that have any of the specified frequencies
    Enum: "paused", "once", "15 minutes", "1 hour", "6 hours", "12 hours", "daily", "weekly", "biweekly", "monthly", "quarterly", "semiannually", "yearly", "custom", "unscheduled"

  - `contractTerm` (object)
    Select specific contract term. Current term will be shown if omitted

  - `contractTerm.startDateInclusive` (string, required)
    Date in ISO 8601 format, in UTC timezone

  - `contractTerm.endDateInclusive` (string, required)
    Date in ISO 8601 format, in UTC timezone

## Response 200 fields (application/json):

  - `pastPeriods` (array, required)
    Represents all past months

  - `pastPeriods.startDateInclusive` (string, required)
    Date in ISO 8601 format, in UTC timezone

  - `pastPeriods.endDateExclusive` (string, required)
    Date in ISO 8601 format, in UTC timezone

  - `pastPeriods.periodTotal` (object, required)
    property can be omitted if filters were not applied

  - `pastPeriods.periodTotal.total` (integer, required)

  - `pastPeriods.periodTotal.filtered` (integer)

  - `pastPeriods.cumulativeTotal` (object, required)
    property can be omitted if filters were not applied

  - `currentPeriod` (object)
    and  calculated for completed runs in current period,  and  estimated for future runs

  - `currentPeriod.periodProjectedTotal` (object, required)
    Duplicates , but includes  and  values for each estimate

  - `currentPeriod.periodProjectedTotal.scheduledUsageEstimate` (object, required)
    property can be omitted if filters were not applied

  - `currentPeriod.periodProjectedTotal.historicalUsageEstimate` (object, required)
    property can be omitted if filters were not applied

  - `currentPeriod.cumulativeProjectedTotal` (object, required)
    Duplicates , but includes  and  values for each estimate

  - `futurePeriods` (array, required)
    Represents future months, with projected values

  - `termLimit` (integer)
    Limit of pages scanned (for audits) or runs completed (for web journeys) for the contract term

  - `limitNoteType` (string)
    Enum: "UNLIMITED", "LIMIT_UNDETERMINED"

  - `monthlyPacing` (integer)
    Shows how many pages should be scanned per month to hit the limit by the end of the contract term

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)