api.video
  1. Webhooks
api.video
  • Account
    • Show account
      GET
  • Analytics
    • List live stream player sessions
      GET
    • List player session events
      GET
    • List video player sessions
      GET
  • Authentication
    • Authenticate
      POST
    • Refresh token
      POST
  • Live
    • List all live streams
      GET
    • Create live stream
      POST
    • Delete a live stream
      DELETE
    • Show live stream
      GET
    • Update a live stream
      PATCH
    • Delete a thumbnail
      DELETE
    • Upload a thumbnail
      POST
  • Players
    • List all players
      GET
    • Create a player
      POST
    • Delete a player
      DELETE
    • Show a player
      GET
    • Update a player
      PATCH
    • Delete logo
      DELETE
    • Upload a logo
      POST
  • Videos - Delegated upload
    • Upload with an upload token
    • List all active upload tokens.
    • Generate an upload token
    • Delete an upload token
    • Show upload token
  • Videos
    • List all videos
    • Create a video
    • Delete a video
    • Show a video
    • Update a video
    • Upload a video
    • Show video status
    • Pick a thumbnail
    • Upload a thumbnail
  • Captions
    • List video captions
    • Delete a caption
    • Show a caption
    • Update caption
    • Upload a caption
  • Chapters
    • List video chapters
    • Delete a chapter
    • Show a chapter
    • Upload a chapter
  • Webhooks
    • List all webhooks
      GET
    • Create Webhook
      POST
    • Delete a Webhook
      DELETE
    • Show Webhook details
      GET
  1. Webhooks

List all webhooks

GET
/webhooks
Webhooks
Requests to this endpoint return a list of your webhooks (with all their details). You can filter what the webhook list that the API returns using the parameters described below.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ws.api.video/webhooks'
Response Response Example
{
  "data": [
    {
      "createdAt": "2021-01-08T14:12:18.000Z",
      "events": [
        "video.encoding.quality.completed"
      ],
      "url": "http://clientnotificationserver.com/notif?myquery=query",
      "webhookId": "webhook_XXXXXXXXXXXXXXX"
    },
    {
      "createdAt": "2021-01-12T12:12:12.000Z",
      "events": [
        "video.encoding.quality.completed"
      ],
      "url": "http://clientnotificationserver.com/notif?myquery=query2",
      "webhookId": "webhook_XXXXXXXXXYYYYYY"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "currentPageItems": 11,
    "itemsTotal": 11,
    "links": [
      {
        "rel": "self",
        "uri": "https://ws.api.video/webhooks?currentPage=1"
      },
      {
        "rel": "first",
        "uri": "https://ws.api.video/webhooks?currentPage=1"
      },
      {
        "rel": "last",
        "uri": "https://ws.api.video/webhooks?currentPage=1"
      }
    ],
    "pageSize": 25,
    "pagesTotal": 1
  }
}

Request

Query Params
events
string 
optional
The webhook event that you wish to filter on.
Example:
video.encoding.quality.completed
currentPage
integer 
optional
Choose the number of search results to return per page. Minimum value: 1
Example:
2
pageSize
integer 
optional
Results per page. Allowed values 1-100, default is 25.
Example:
30

Responses

🟢200Success
application/json
Body
data
array[object (Webhook) {4}] 
optional
createdAt
string <date-time>
optional
When an webhook was created, presented in ISO-8601 format.
Example:
2019-06-24T11:45:01.109Z
events
array[string]
optional
A list of events that will trigger the webhook.
Example:
["video.encoding.quality.completed"]
url
string 
optional
URL of the webhook
Example:
http://clientnotificationserver.com/notif?myquery=query
webhookId
string 
optional
Unique identifier of the webhook
Example:
webhook_XXXXXXXXXXXXXXX
pagination
object (Pagination) 
optional
Example:
{"currentPage":3,"currentPageItems":20,"itemsTotal":123,"links":{"first":{"rel":"first","uri":"/videos/search?currentPage=1&pageSize=20"},"last":{"rel":"last","uri":"/videos/search?currentPage=6&pageSize=20"},"next":{"rel":"next","uri":"/videos/search?currentPage=4&pageSize=20"},"previous":{"rel":"previous","uri":"/videos/search?currentPage=2&pageSize=20"}},"pageSize":20,"pagesTotal":7}
currentPage
integer 
read-onlyoptional
The current page index.
currentPageItems
integer 
read-onlyoptional
The number of items on the current page.
itemsTotal
integer 
read-onlyoptional
Total number of items that exist.
links
array[object (PaginationLink) {2}] 
required
pageSize
integer 
read-onlyoptional
Maximum number of item per page.
pagesTotal
integer 
read-onlyoptional
Number of items listed in the current page.
Modified at 2023-08-15 05:52:15
Previous
Upload a chapter
Next
Create Webhook
Built with