---
title: "Counts custom events"
method: GET
path: "/v1/query/web-analytics/events/count"
tags: ["web-analytics"]
---

# Counts custom events

`GET /v1/query/web-analytics/events/count`

Counts the number of custom events on a project (production only), since Web Analytics was enabled. Results can be filtered on supported dimensions.

## Query parameters

- `projectId` string, required — The project identifier or the project name
- `since` union — Timestamp in milliseconds, or a valid Date string. Selects data from (including) this date and time. Will be adjusted according to the desired time granularity.
  - number
  - string
- `until` union — Timestamp in milliseconds, or a valid Date string. Selects data until (including) this date. Will be adjusted according to the desired time granularity.
  - number
  - string
- `filter` string — OData-compliant filter. Encode the value when sending it in a URL. Allows filtering on one or multiple dimensions. Supported dimensions: country, deviceType, environment, requestPath, referrerHostname, osName, browserName, route, utmSource, utmMedium, utmCampaign, utmContent, utmTerm, eventName. JSON dimensions filtered by key: flags/<name>, eventData/<property>, for example eventData/plan eq 'pro'. Wrap keys containing characters other than letters, digits, and underscores in single quotes, for example flags/'my-flag' eq 'true'. Supported operations include eq, ne, in, and logical operators and, or, not with parentheses. Functions such as startswith are supported by the OData parser.
- `teamId` string
- `slug` string

## Response `200`

- object
  - `version` number, required
  - `query` object, required
    - `since` string, required
    - `until` string, required
    - `filter` string
  - `data` object, required
    - `projectId` string, required
    - `country` string, required
    - `deviceType` string, required
    - `environment` string, required
    - `requestPath` string, required
    - `referrerHostname` string, required
    - `osName` string, required
    - `browserName` string, required
    - `route` string, required
    - `utmSource` string, required
    - `utmMedium` string, required
    - `utmCampaign` string, required
    - `utmContent` string, required
    - `utmTerm` string, required
    - `flags` string, required
    - `errorMessage` string, required
    - `entryRevalidateSeconds` string, required
    - `projectName` string, required
    - `deploymentId` string, required
    - `pathType` string, required
    - `pathTypeVariant` string, required
    - `requestHostname` string, required
    - `requestResolvedIp` string, required
    - `requestMethod` string, required
    - `requestExtension` string, required
    - `requestId` string, required
    - `requestApi` string, required
    - `referrerUrl` string, required
    - `serverActionName` string, required
    - `httpStatus` string, required
    - `errorCode` string, required
    - `source` string, required
    - `edgeType` string, required
    - `reason` string, required
    - `edgeNetworkRegion` string, required
    - `functionRegion` string, required
    - `imageTransformationRegion` string, required
    - `dataCacheRegion` string, required
    - `cause` string, required
    - `runtime` string, required
    - `provider` string, required
    - `isrCacheRegion` string, required
    - `isrAction` string, required
    - `cacheResult` string, required
    - `cacheOperation` string, required
    - `cacheHostname` string, required
    - `cachePath` string, required
    - `cacheHitState` string, required
    - `cacheHitLevel` string, required
    - `cacheApi` string, required
    - `cacheReason` string, required
    - `clientIp` string, required
    - `clientIpCountry` string, required
    - `clientUserAgent` string, required
    - `httpAccept` string, required
    - `clientJa4Digest` string, required
    - `asnId` string, required
    - `asnName` string, required
    - `botName` string, required
    - `botCategory` string, required
    - `botCategoryLegacy` string, required
    - `botVerified` string, required
    - `botCheckResult` string, required
    - `deepAnalysisCheck` string, required
    - `wafAction` string, required
    - `wafRuleId` string, required
    - `skewProtection` string, required
    - `functionStartType` string, required
    - `functionDispatcher` string, required
    - `isAdditionalRequest` string, required
    - `originHostname` string, required
    - `originPath` string, required
    - `originRoute` string, required
    - `fetchType` string, required
    - `fetchIndex` string, required
    - `imageSource` string, required
    - `sourceImage` string, required
    - `sourceImagePathname` string, required
    - `sourceImageHostname` string, required
    - `sourceImageHash` string, required
    - `optimizedQuality` string, required
    - `optimizedWidthPixels` string, required
    - `optimizedFormatMimeType` string, required
    - `vdcOperationOrigin` string, required
    - `entryName` string, required
    - `entryId` string, required
    - `entryItemId` string, required
    - `tagName` string, required
    - `cacheTags` string, required
    - `storeId` string, required
    - `storeName` string, required
    - `blobOperationType` string, required
    - `blobOperationLevel` string, required
    - `visitorId` string, required
    - `eventName` string, required
    - `attributionTarget` string, required
    - `attributionEventName` string, required
    - `metricName` string, required
    - `attributes` string, required
    - `flagKey` string, required
    - `flagVariant` string, required
    - `flagEvaluationReason` string, required
    - `flagClientName` string, required
    - `sdkKeyId` string, required
    - `sdkKeyEnvironment` string, required
    - `reportingProjectId` string, required
    - `reportingProjectName` string, required
    - `eventData` string, required
    - `middlewareAction` string, required
    - `middlewareActionTarget` string, required
    - `aiModel` string, required
    - `aiGatewayModelId` string, required
    - `aiProvider` string, required
    - `aiModelType` string, required
    - `servedSpeed` string, required
    - `virtualModelSlug` string, required
    - `virtualModelKind` string, required
    - `inferenceEndpointSlug` string, required
    - `inferenceScope` string, required
    - `inferenceGeoRegion` string, required
    - `inferenceProviderRegion` string, required
    - `requestedInferenceRegion` string, required
    - `costCurrency` string, required
    - `marketCostCurrency` string, required
    - `cachedInputTokensCurrency` string, required
    - `cacheCreationInputTokensCurrency` string, required
    - `cacheCreation1hInputTokensCurrency` string, required
    - `surchargeCostCurrency` string, required
    - `gatewayCostCurrency` string, required
    - `keyId` string, required
    - `keyName` string, required
    - `authMethod` string, required
    - `appName` string, required
    - `codingAgent` string, required
    - `isByok` string, required
    - `isPrivateModel` string, required
    - `isRequestZdr` string, required
    - `hipaaRequested` string, required
    - `quotaRequested` string, required
    - `quotaEntityId` string, required
    - `quotaEntityType` string, required
    - `videoResolution` string, required
    - `videoAspectRatio` string, required
    - `piiRedactionApplied` string, required
    - `moderationApplied` string, required
    - `queueName` string, required
    - `consumerGroup` string, required
    - `messageId` string, required
    - `eventType` string, required
    - `notificationUrl` string, required
    - `sandboxSessionId` string, required
    - `sandboxName` string, required
    - `workflowRunId` string, required
    - `workflowName` string, required
    - `workflowStatus` string, required
    - `stepRunId` string, required
    - `workflowStepName` string, required
    - `workflowEventType` string, required
    - `region` string, required
    - `specVersion` string, required
    - `contentType` string, required
    - `rewriteDestinationHostname` string, required
    - `externalRewriteTargetHost` string, required
    - `externalRewriteTargetPath` string, required
    - `commitSha` string, required
    - `reviewConclusion` string, required
    - `pullRequestNumber` string, required
    - `repositoryName` string, required
    - `repositoryOwner` string, required
    - `reviewStatus` string, required
    - `pullRequestState` string, required
    - `triggeringTag` string, required
    - `redirectLocation` string, required
    - `microfrontendsResponseReason` string, required
    - `microfrontendsMatchedPath` string, required
    - `microfrontendsDefaultAppDeploymentId` string, required
    - `microfrontendsDefaultAppProjectId` string, required
    - `service` string, required
    - `isPrefetchRequest` string, required
    - `spendReportGroupBy` string, required
    - `spendReportDatePart` string, required
    - `providerAttemptCanonicalSlug` string, required
    - `providerAttemptCredentialType` string, required
    - `providerAttemptSuccess` string, required
    - `providerAttemptStatusCode` string, required
    - `providerAttemptTimeout` string, required
    - `providerAttemptIsFinal` string, required
    - `providerAttemptNumber` string, required
    - `providerAttemptTotalInRequest` string, required
    - `generationId` string, required
    - `sessionId` string, required
    - `contentCaptureStatus` string, required
    - `contentCaptureInputs` string, required
    - `contentCaptureOutputs` string, required
    - `transcriptStatus` string, required
    - `transcriptInputs` string, required
    - `transcriptOutputs` string, required
    - `providerAttemptError` string, required
    - `providerAttemptSafetyIdentifier` string, required
    - `providerAttemptDevSafetyIdentifier` string, required
    - `providerAttemptRegion` string, required
    - `providerAttemptModelIndex` string, required
    - `toolCallType` string, required
    - `toolCallProvider` string, required
    - `toolCallSuccess` string, required
    - `toolCallErrorType` string, required
    - `toolCallStatusCode` string, required
    - `environmentId` string, required
    - `billableRegion` string, required
    - `direction` string, required
    - `networkTenancy` string, required
    - `trafficSource` string, required
    - `networkId` string, required
    - `privatelinkEndpointId` string, required
    - `privatelinkDnsName` string, required
    - `privatelinkIpAddress` string, required

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `402`
- `403` — You do not have permission to access this resource.
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)