> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Get detailed campaign statistics

> Get send statistics and conversions for one campaign.

> [!NOTE]
>
> **Data availability**
>
> Check the previous day's data after 7 a.m. KST.

> [!NOTE]
>
> **Campaign Statistics API changes**
>
> The `conversionType` field was added on 2025-07-06.


## OpenAPI

````yaml /en/api-reference/openapi.yaml get /projects/{projectId}/campaigns/{campaignId}/stats
openapi: 3.0.3
info:
  title: Notifly API
  version: 1.0.0
  contact:
    email: contact@notifly.tech
servers:
  - url: https://api.notifly.tech
    description: Notifly API server
security: []
tags:
  - name: catalog
    x-group: Catalogs
paths:
  /projects/{projectId}/campaigns/{campaignId}/stats:
    get:
      summary: get-campaign-statistics-retrieval
      operationId: getCampaignStatisticsRetrieval
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: Project ID.
        - name: campaignId
          in: path
          required: true
          schema:
            type: string
          description: Campaign ID.
        - name: start
          in: query
          required: true
          schema:
            type: string
            format: date-time
          description: Inclusive start time in UTC, in `yyyy-MM-ddTHH:00:00.000Z` format.
          example: '2024-10-27T15:00:00.000Z'
        - name: end
          in: query
          required: true
          schema:
            type: string
            format: date-time
          description: Exclusive end time in UTC, in `yyyy-MM-ddTHH:00:00.000Z` format.
          example: '2024-10-29T15:00:00.000Z'
      responses:
        '200':
          description: Message statistics retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      lastCollectedAt:
                        type: string
                        description: >-
                          Time when the statistics were last aggregated, in
                          `yyyy-MM-dd HH:mm:ss` format, in KST.
                      stats:
                        type: array
                        items:
                          $ref: '#/components/schemas/CampaignStatsMetric'
                  error:
                    type: string
                    nullable: true
              example:
                data:
                  lastCollectedAt: '2024-10-29 04:00:00'
                  stats:
                    - metricName: 구매_이벤트
                      metricType: conversion
                      conversionType: sales_conversion
                      totalSum: 930832
                      dailySums:
                        - date: '2024-09-30'
                          sum: 0
                          dimensionSums:
                            - dimensionKey: 이름
                              dimensionValue: 이름1
                              sum: 0
                    - metricName: send_success
                      metricType: standard
                      totalCount: 550
                      dailyCounts:
                        - date: '2024-10-28'
                          count: 250
                          dimensionCounts:
                            - dimensionKey: region
                              dimensionValue: us-east
                              count: 100
                            - dimensionKey: region
                              dimensionValue: us-west
                              count: 150
                        - date: '2024-10-29'
                          count: 300
                          dimensionCounts:
                            - dimensionKey: region
                              dimensionValue: us-east
                              count: 200
                            - dimensionKey: region
                              dimensionValue: us-west
                              count: 100
                error: null
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: string
                    nullable: true
                  error:
                    type: string
              example:
                data: null
                error: Invalid project ID
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: string
                    nullable: true
                  error:
                    type: string
              example:
                data: null
                error: 'Unauthorized: Invalid Authorization Token'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: string
                    nullable: true
                  error:
                    type: string
              example:
                data: null
                error: 'Internal Server Error: some-error-message'
      security:
        - bearerAuth: []
components:
  schemas:
    CampaignStatsMetric:
      type: object
      properties:
        metricName:
          type: string
          description: The name of the aggregated metric.
        metricType:
          type: string
          enum:
            - standard
            - conversion
          description: The metric type.
        conversionType:
          type: string
          enum:
            - direct_count_conversion
            - total_count_conversion
            - sales_conversion
          description: >-
            The conversion metric type. Present only when `metricType` is
            `conversion`.
        totalCount:
          type: integer
          description: The total count for the metric during the specified period.
        totalSum:
          type: number
          description: >-
            The total sum for the metric during the specified period, for
            `sales_conversion`.
        dailyCounts:
          type: array
          items:
            type: object
            properties:
              date:
                type: string
                description: The aggregation date in `yyyy-MM-dd` format, in KST.
              count:
                type: integer
                description: The metric count for the date.
              dimensionCounts:
                type: array
                items:
                  type: object
                  properties:
                    dimensionKey:
                      type: string
                      description: The user property key.
                    dimensionValue:
                      type: string
                      description: The user property value.
                    count:
                      type: integer
                      description: The metric count for the property value.
          description: The metric data aggregated by day.
        dailySums:
          type: array
          items:
            type: object
            properties:
              date:
                type: string
                description: The aggregation date in `yyyy-MM-dd` format, in KST.
              sum:
                type: number
                description: The sum for the date.
              dimensionSums:
                type: array
                items:
                  type: object
                  properties:
                    dimensionKey:
                      type: string
                      description: The user property key.
                    dimensionValue:
                      type: string
                      description: The user property value.
                    sum:
                      type: number
                      description: The sum for the property value.
          description: The metric data aggregated by day, for `sales_conversion`.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Pass the token issued by `POST /authenticate` as a bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.