# Get filterable specific item type usage summary for account. If web journeys are not included in contract, 404 status code will be returned

POST /v3/usage/{itemType}/summary

Endpoint: POST /v3/usage/{itemType}/summary
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):

  - `currentContractTerm` (object, required)
    Contract start and end dates

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

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

  - `contractTerms` (array, required)
    Dates of contracts

  - `usage` (object, required)
    Subtypes:
- AccountUsageV2_SpecificItemTypeSummary_AuditUsage
- AccountUsageV2_SpecificItemTypeSummary_WebJourneyUsage

 - number of pages scanned (for audits) or runs completed (for web journeys) to date.
,  - can be omitted if there is no limit.
 is only visible to account admins.

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

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

  - `usage.cumulativeTotal.total` (integer, required)

  - `usage.cumulativeTotal.filtered` (integer)

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

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

  - `usage.cumulativePacing` (integer)
    Shows how many pages should be scanned to date to hit the limit by the end of the contract term

  - `usage.overLimitPrice` (object)
    Price of a page scan (for audits) or a run (for web journeys) over the limit

  - `usage.overLimitPrice.amount` (number, required)
    Example: 0.01

  - `usage.overLimitPrice.currency` (string, required)
    A currency represented by its ISO 4217 alpha code
    Example: "USD"

## 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)

## Response 404 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)