Panda Video Notifications API

The Notifications API from Panda Video — 7 operation(s) for notifications.

GitHub OpenAPI

Operations 9

PUT /me Update Login Language #
GET /notifications/contacts List Notification Contacts #
POST /notifications/contacts Add Notification Contact #
DELETE /notifications/contacts/{contact_id} Delete Notification Contact #
GET /notifications/dashboard List Dashboard Cards #
PUT /notifications/dashboard/dismiss Dismiss Cards #
PUT /notifications/dashboard/read Mark Cards as Read #
GET /notifications/preferences List Notification Preferences #
PUT /notifications/preferences Update Notification Preferences #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pandavideo-com:pandavideo-com-notifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pandavideo-com-notifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Panda Notifications API
  version: 1.0.0
servers:
- url: https://api-v2.pandavideo.com.br
tags:
- name: Notifications
paths:
  /me:
    put:
      operationId: update-login-language
      summary: Update Login Language
      description: Updates the notification language for the authenticated login. Notifications are sent in this language. Logins without a language receive them in English.
      tags:
      - Notifications
      security:
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - type
              - language
              properties:
                type:
                  type: string
                  enum:
                  - update_language
                  description: Action type. Must be update_language.
                language:
                  type: string
                  enum:
                  - pt
                  - en
                  - es
                  description: Notification language. pt for Portuguese, en for English, es for Spanish.
              example:
                type: update_language
                language: pt
      responses:
        '200':
          description: Language updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: integer
                    description: Number of items affected.
                example:
                  updated: 1
        '400':
          description: Invalid language
          content:
            application/json:
              schema:
                type: object
                properties:
                  errCode:
                    type: string
                  errMsg:
                    type: string
                example:
                  errCode: INVALID_LANGUAGE
                  errMsg: language must be pt, en or es.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/contacts:
    get:
      operationId: list-notification-contacts
      summary: List Notification Contacts
      description: Returns the notification contacts for the authenticated login, including invalidation reason when an address was bounced or marked as spam.
      tags:
      - Notifications
      security:
      - apiKey: []
      responses:
        '200':
          description: Contact list
          content:
            application/json:
              schema:
                type: object
                properties:
                  contacts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Contact ID.
                        type:
                          type: string
                          enum:
                          - email
                          - phone
                          description: Contact type. Lowercase.
                        value:
                          type: string
                          description: Email address or phone number in international format (+5511999990000).
                        invalid_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                          description: When the contact was invalidated, or null.
                        invalid_reason:
                          type:
                          - string
                          - 'null'
                          enum:
                          - bounce
                          - complaint
                          - null
                          description: 'Why the contact was invalidated: bounce (permanent delivery failure) or complaint (marked as spam).'
                example:
                  contacts:
                  - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    type: email
                    value: alerts@mycompany.com
                    invalid_at: null
                    invalid_reason: null
                  - id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                    type: phone
                    value: '+5511999990000'
                    invalid_at: null
                    invalid_reason: null
                  - id: c3d4e5f6-a7b8-9012-cdef-123456789012
                    type: email
                    value: old@example.com
                    invalid_at: '2026-09-15T10:30:00.000Z'
                    invalid_reason: bounce
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
    post:
      operationId: add-notification-contact
      summary: Add Notification Contact
      description: Registers an email or phone contact for the authenticated login. Up to 3 per type.
      tags:
      - Notifications
      security:
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - type
              - value
              properties:
                type:
                  type: string
                  enum:
                  - email
                  - phone
                  description: Contact type. Lowercase.
                value:
                  type: string
                  description: 'Email address or phone in international format with country code: +5511999990000.'
              example:
                type: email
                value: alerts@mycompany.com
      responses:
        '200':
          description: Contact created
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  type:
                    type: string
                  value:
                    type: string
                example:
                  id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  type: email
                  value: alerts@mycompany.com
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errCode:
                    type: string
                    enum:
                    - CONTACT_ALREADY_EXISTS
                    - CONTACT_LIMIT_REACHED
                    - BadRequest
                  errMsg:
                    type: string
                example:
                  errCode: CONTACT_LIMIT_REACHED
                  errMsg: Maximum of 3 email contacts reached.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/contacts/{contact_id}:
    delete:
      operationId: delete-notification-contact
      summary: Delete Notification Contact
      description: Removes a notification contact from the authenticated login.
      tags:
      - Notifications
      security:
      - apiKey: []
      parameters:
      - name: contact_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: The ID of the contact to remove.
      responses:
        '200':
          description: Contact deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  deleted:
                    type: boolean
                  type:
                    type: string
                  value:
                    type: string
                example:
                  deleted: true
                  type: email
                  value: alerts@mycompany.com
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/dashboard:
    get:
      operationId: list-dashboard-cards
      summary: List Dashboard Cards
      description: Lists non-dismissed notification cards for the authenticated login, newest first, with unread count. Cards are retained for 7 days.
      tags:
      - Notifications
      security:
      - apiKey: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 50
        description: Number of cards to return. Between 1 and 100, defaults to 50.
      - name: before
        in: query
        required: false
        schema:
          type: string
        description: Cursor for pagination. Use the next value from the previous response.
      responses:
        '200':
          description: Card list with unread count
          content:
            application/json:
              schema:
                type: object
                properties:
                  cards:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Card ID.
                        event_type:
                          type: string
                          description: Event that generated this card.
                        data:
                          type: object
                          description: Event-specific payload. Contains the last item and aggregation window for grouped events.
                          properties:
                            count:
                              type: integer
                              description: Number of items grouped in this card.
                            windowStart:
                              type: string
                              format: date-time
                              description: Start of the 30-minute grouping window.
                            windowEnd:
                              type: string
                              format: date-time
                              description: End of the 30-minute grouping window.
                        item_count:
                          type: integer
                          description: Number of items grouped in this card.
                        occurred_at:
                          type: string
                          format: date-time
                          description: When the first event in the group occurred.
                        created_at:
                          type: string
                          format: date-time
                          description: When the card was created.
                        read_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                          description: When the card was marked as read, or null.
                        dismissed_at:
                          type:
                          - string
                          - 'null'
                          format: date-time
                          description: When the card was dismissed, or null.
                  unread:
                    type: integer
                    description: Total number of unread cards.
                  next:
                    type:
                    - string
                    - 'null'
                    description: Cursor for the next page. Pass as before query parameter. null when there are no more pages.
                example:
                  cards:
                  - id: d4e5f6a7-b8c9-0123-defg-456789012345
                    event_type: VIDEO_READY
                    data:
                      count: 3
                      windowStart: '2026-10-09T14:00:00.000Z'
                      windowEnd: '2026-10-09T14:30:00.000Z'
                    item_count: 3
                    occurred_at: '2026-10-09T14:05:00.000Z'
                    created_at: '2026-10-09T14:30:00.000Z'
                    read_at: null
                    dismissed_at: null
                  - id: e5f6a7b8-c9d0-1234-efgh-567890123456
                    event_type: BILLING_FAILED
                    data:
                      count: 1
                      windowStart: '2026-10-09T10:00:00.000Z'
                      windowEnd: '2026-10-09T10:30:00.000Z'
                    item_count: 1
                    occurred_at: '2026-10-09T10:12:00.000Z'
                    created_at: '2026-10-09T10:30:00.000Z'
                    read_at: '2026-10-09T11:00:00.000Z'
                    dismissed_at: null
                  unread: 1
                  next: eyJjcmVhdGVkX2F0IjoiMjAyNi0xMC0wOVQxMDozMDowMC4wMDBaIn0=
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errCode:
                    type: string
                  errMsg:
                    type: string
                example:
                  errCode: BadRequest
                  errMsg: limit must be between 1 and 100
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/dashboard/dismiss:
    put:
      operationId: dismiss-cards
      summary: Dismiss Cards
      description: Dismisses notification cards (removes from the list). Without ids, dismisses all cards for the login. Send ids to act on specific cards.
      tags:
      - Notifications
      security:
      - apiKey: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: Card IDs to act on. Omit or send empty body to act on all cards.
              example:
                ids:
                - d4e5f6a7-b8c9-0123-defg-456789012345
      responses:
        '200':
          description: Update count
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: integer
                    description: Number of items affected.
                example:
                  updated: 1
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/dashboard/read:
    put:
      operationId: mark-cards-as-read
      summary: Mark Cards as Read
      description: Marks notification cards as read. Without ids, marks all cards for the login. Send ids to act on specific cards.
      tags:
      - Notifications
      security:
      - apiKey: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: Card IDs to act on. Omit or send empty body to act on all cards.
              example:
                ids:
                - d4e5f6a7-b8c9-0123-defg-456789012345
                - e5f6a7b8-c9d0-1234-efgh-567890123456
      responses:
        '200':
          description: Update count
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: integer
                    description: Number of items affected. Re-marking an already-read card returns 0.
                example:
                  updated: 2
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
  /notifications/preferences:
    get:
      operationId: list-notification-preferences
      summary: List Notification Preferences
      description: 'Returns the full preference matrix for the authenticated login: 40 event-channel pairs with current and default values.'
      tags:
      - Notifications
      security:
      - apiKey: []
      responses:
        '200':
          description: Preference matrix
          content:
            application/json:
              schema:
                type: object
                properties:
                  preferences:
                    type: array
                    description: Array of 40 event-channel pairs.
                    items:
                      type: object
                      properties:
                        event_type:
                          type: string
                          description: Event identifier.
                          enum:
                          - BILLING_FAILED
                          - BILLING_UPCOMING
                          - CARD_EXPIRING
                          - BANDWIDTH_EXCEEDED
                          - STORAGE_EXCEEDED
                          - BANDWIDTH_NEAR_LIMIT
                          - STORAGE_NEAR_LIMIT
                          - VIDEO_READY
                          - VIDEO_FAILED
                          - VIDEO_DELETED
                          - FOLDER_DELETED
                          - CAPTIONS_READY
                          - DUBBING_READY
                          - AI_FAILED
                          - AI_PACKAGE_READY
                          - SHORTS_READY
                          - PASSWORD_CHANGED
                          - NEW_DEVICE_LOGIN
                          - MFA_DISABLED
                        category:
                          type: string
                          description: Event category.
                          enum:
                          - BILLING_ACCOUNT
                          - VIDEO
                          - PANDA_AI
                          - ACCOUNT_SECURITY
                        channel:
                          type: string
                          description: Delivery channel.
                          enum:
                          - EMAIL
                          - SMS
                          - WHATSAPP
                          - DASHBOARD
                        enabled:
                          type: boolean
                          description: Whether this pair is enabled for the login.
                        mandatory:
                          type: boolean
                          description: Whether this pair is mandatory (cannot be disabled). Currently always false.
                        available:
                          type: boolean
                          description: Whether this channel is available for this event. VIDEO and PANDA_AI events do not support SMS or WHATSAPP.
                        default_enabled:
                          type: boolean
                          description: The default value for this pair when the login has not customized it.
                example:
                  preferences:
                  - event_type: BILLING_FAILED
                    category: BILLING_ACCOUNT
                    channel: EMAIL
                    enabled: true
                    mandatory: false
                    available: true
                    default_enabled: true
                  - event_type: BILLING_FAILED
                    category: BILLING_ACCOUNT
                    channel: DASHBOARD
                    enabled: true
                    mandatory: false
                    available: true
                    default_enabled: true
                  - event_type: VIDEO_READY
                    category: VIDEO
                    channel: EMAIL
                    enabled: false
                    mandatory: false
                    available: true
                    default_enabled: false
                  - event_type: VIDEO_READY
                    category: VIDEO
                    channel: SMS
                    enabled: false
                    mandatory: false
                    available: false
                    default_enabled: false
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
    put:
      operationId: update-notification-preferences
      summary: Update Notification Preferences
      description: Enables or disables event-channel pairs. Only the pairs sent are changed; the response is the full matrix. Send {"action":"restore_defaults"} to reset all preferences to their defaults.
      tags:
      - Notifications
      security:
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                preferences:
                  type: array
                  description: Pairs to update. Only the pairs sent are changed.
                  items:
                    type: object
                    required:
                    - event_type
                    - channel
                    - enabled
                    properties:
                      event_type:
                        type: string
                        description: Event identifier.
                      channel:
                        type: string
                        description: 'Delivery channel. Uppercase: EMAIL, SMS, WHATSAPP, DASHBOARD.'
                      enabled:
                        type: boolean
                        description: Enable or disable this pair.
                action:
                  type: string
                  enum:
                  - restore_defaults
                  description: Send restore_defaults (without preferences) to reset all preferences to their defaults.
              example:
                preferences:
                - event_type: VIDEO_READY
                  channel: EMAIL
                  enabled: true
                - event_type: BILLING_FAILED
                  channel: DASHBOARD
                  enabled: false
      responses:
        '200':
          description: Updated preference matrix
          content:
            application/json:
              schema:
                type: object
                properties:
                  preferences:
                    type: array
                    description: Array of 40 event-channel pairs.
                    items:
                      type: object
                      properties:
                        event_type:
                          type: string
                        category:
                          type: string
                        channel:
                          type: string
                        enabled:
                          type: boolean
                        mandatory:
                          type: boolean
                        available:
                          type: boolean
                        default_enabled:
                          type: boolean
                example:
                  preferences:
                  - event_type: VIDEO_READY
                    category: VIDEO
                    channel: EMAIL
                    enabled: true
                    mandatory: false
                    available: true
                    default_enabled: false
                  - event_type: BILLING_FAILED
                    category: BILLING_ACCOUNT
                    channel: DASHBOARD
                    enabled: false
                    mandatory: false
                    available: true
                    default_enabled: true
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errCode:
                    type: string
                    enum:
                    - CHANNEL_UNAVAILABLE
                    - INVALID_PREFERENCE
                    - CONFLICTING_PREFERENCE
                    - BadRequest
                  errMsg:
                    type: string
                  detail:
                    type: string
                example:
                  errCode: CHANNEL_UNAVAILABLE
                  errMsg: SMS is not available for VIDEO_READY
                  detail: VIDEO and PANDA_AI events do not support SMS or WHATSAPP channels.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Unauthorized
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header
x-provenance:
  method: searched
  source: https://docs.pandavideo.com/reference
  harvested: '2026-11-20'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.pandavideo.com/reference/add-notification-contact.md
  - https://docs.pandavideo.com/reference/delete-notification-contact.md
  - https://docs.pandavideo.com/reference/dismiss-cards.md
  - https://docs.pandavideo.com/reference/list-dashboard-cards.md
  - https://docs.pandavideo.com/reference/list-notification-contacts.md
  - https://docs.pandavideo.com/reference/list-notification-preferences.md
  - https://docs.pandavideo.com/reference/mark-cards-as-read.md
  - https://docs.pandavideo.com/reference/update-login-language.md
  - https://docs.pandavideo.com/reference/update-notification-preferences.md
  merge:
    pages: 9
    deduped: 8
    conflicts_kept_first: 0