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

# Get a notification

> Returns aggregate lifecycle counts for a notification.



## OpenAPI

````yaml /openapi.yaml get /api/v1/notifications/{notificationId}
openapi: 3.0.3
info:
  title: Pushctl API
  version: 1.0.0
  description: >-
    Application-scoped APIs for registering installations, sending push
    notifications, and tracking delivery events.
  license:
    name: Proprietary
servers:
  - url: https://pushctl.com
security:
  - bearerAuth: []
tags:
  - name: Installations
    description: Register and maintain mobile app installations.
  - name: Notifications
    description: Create notifications and inspect their delivery lifecycle.
  - name: Delivery events
    description: Report lifecycle events emitted by a client installation.
paths:
  /api/v1/notifications/{notificationId}:
    parameters:
      - in: path
        name: notificationId
        required: true
        description: Notification ULID.
        schema:
          type: string
        example: 01K2EXAMPLE7QY5V4DPM8A0Z
    get:
      tags:
        - Notifications
      summary: Get a notification
      description: Returns aggregate lifecycle counts for a notification.
      operationId: getANotification
      responses:
        '200':
          description: Notification found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    NotificationResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/Notification'
    Notification:
      type: object
      required:
        - id
        - status
        - notification
        - data
        - options
        - target_users
        - statistics
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/NotificationStatus'
        notification:
          type: object
          properties:
            title:
              type: string
              nullable: true
            body:
              type: string
              nullable: true
            image_url:
              type: string
              nullable: true
            action_url:
              type: string
              nullable: true
        data:
          type: object
          additionalProperties: true
        options:
          type: object
          additionalProperties: true
        target_users:
          type: integer
        statistics:
          type: object
          properties:
            users:
              type: integer
            installations:
              type: integer
            accepted:
              type: integer
            received:
              type: integer
            displayed:
              type: integer
            opened:
              type: integer
            failed:
              type: integer
            skipped:
              type: integer
        created_at:
          type: string
          format: date-time
          nullable: true
        processing_started_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string
    NotificationStatus:
      type: string
      enum:
        - queued
        - processing
        - completed
        - partial
        - failed
  responses:
    Unauthenticated:
      description: Token is missing, invalid, or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Unauthenticated.
    Forbidden:
      description: The token lacks the required ability.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: This action is unauthorized.
    NotFound:
      description: Resource was not found for this application.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Not Found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: application token
      description: >-
        Use an application-scoped token with the ability required by the
        endpoint.

````