REST API Overview

In order to interface with some of the core functionality, Vouch has exposed specific resources via a REST API. This gives developers a great deal of flexibility when integrating Vouch and opens up the doors to very exciting activations.

The Vouch REST API is only available for customers who have purchased the entitlement as part of their plan.

Base URL

The API is accessed using a base URL in the form:

https://api.vouchfor.com/api/v1/<resource>  

Authentication

All requests to the API are authenticated by providing your API key. The API key should be provided as an HTTP header named X-API-KEY .

"X-API-KEY: YOUR_TOKEN" https://api.vouchfor.com/api/v1/<resource>  

Your API Key can be found in your account on the the Developer page within your Vouch Account. The REST API is only available for customers who have purchased the entitlement as part of their plan.

HTTP Method

The v1 API uses standard HTTP methods for indicating the action to take on a resource.

Method Action
GET Retrieve a resource.
POST Create, modify or delete a resource.

Schema

All API requests and response bodies adhere to a common JSON format representing individual items and collections of items.

Errors

The API uses HTTP status codes to indicate an error has occurred while processing a request. There are five main error status codes used by the API:

Code Description
401 Invalid API key
403 The request could not be authenticated or the authenticated user is not authorized to access the requested resource.
404 The requested resource does not exist.
422 The request could not be processed, usually due to a missing or invalid parameter.
500 Server Error

REST API Calls

Vouch currently offers a suite of RESTful API endpoints. These APIs have be grouped under the section of the Platform they relate to. To find out more about a specific API call, simply click on the event below.

The endpoints are grouped by the area of the platform they relate to. Select an endpoint to see its full reference, including parameters and example responses, on the Vouch Developer Portal.

Advocacy

Endpoint Method
Create Advocacy Request POST
Update Advocacy Request POST
Get Advocacy Request GET
Delete Advocacy Request POST
Publish Advocacy Request POST
Pause Advocacy Request POST
Archive Advocacy Request POST
Update Advocacy Request Metrics POST
Search Advocacy Requests GET
Create Advocacy Share POST
List Advocacy Shares GET
List Advocacy Request Shares GET
Get Advocacy Share GET
Update Advocacy Share Metrics POST

Audio

Endpoint Method
Upload Audio POST
Get Audio GET
Search Audios GET
Delete Audio POST

Campaign (Requests)

Endpoint Method
Create Campaign POST
List Campaigns GET
Update Campaign POST
Delete Campaign POST
Publish Campaign POST
Pause Campaign POST
Get Campaign GET
Get Campaign Counts GET
Convert Campaign POST
Submit Campaign POST
List Campaign Vouches GET
Search Campaigns GET
Get Campaign Status GET
Get Campaign Responses GET
Get Campaign Keywords GET
Get Campaign Clips GET

Chat

Endpoint Method
Prompt Chat (new chat) POST
List Chats GET
Prompt Chat (existing chat) POST
Get Chat GET
Get Chat History GET

Clip

Endpoint Method
Search Clips GET

Composition

Endpoint Method
Create Composition POST
List Compositions GET
Update Composition POST
Get Composition GET
Search Compositions GET
Get Composition Counts GET
Delete Composition POST

Content

Endpoint Method
Create Content POST
Get Content GET
Search Contents GET
Delete Content POST

Document

Endpoint Method
Upload Document POST
Get Document GET
Search Documents GET
Delete Document POST

Entity

Endpoint Method
Create Entity POST
List Entities GET
Update Entity POST
Get Entity GET
Get Media Token GET
Get Brand Settings GET
List Active Users GET
Search Contacts GET
List Video Templates GET
List Tags GET

File

Endpoint Method
Get File GET
Search Files GET
Delete File POST

Image

Endpoint Method
Upload Image POST
Get Image GET
Search Images GET
Delete Image POST
Endpoint Method
Import Link POST
Get Link GET
Search Links GET
Delete Link POST

Meeting

Endpoint Method
Create Meeting POST
Search Meetings GET
Get Meeting GET
Update Meeting POST
Delete Meeting POST

Playlist

Endpoint Method
Create Playlist POST
List Playlists GET
Update Playlist POST
Get Playlist GET
Search Playlists GET
Download Playlist POST
List Playlist Downloads GET
Get Playlist Counts GET
Delete Playlist POST
Title Playlist Videos POST

Project

Endpoint Method
Create Project POST
List Projects GET
Get Project GET
Update Project POST
Delete Project POST
Search Projects GET
List Project Items GET
Link Project Items POST
Unlink Project Items POST

Tag

Endpoint Method
Apply Tags POST
Remove Tags POST

Vouch (Videos)

Endpoint Method
Create Vouch POST
List Vouches GET
Update Vouch POST
Get Vouch GET
Delete Vouch POST
Download Vouch POST
List Vouch Downloads GET
Upload Vouch POST
Search Vouches GET
Get Vouch Counts GET
Get Vouch Status GET
Resolve Quotes POST
Get Vouch Clips GET
Create Vouch Clips POST
Delete Vouch Clips POST
Get Vouch Clips (by question) GET
Create Vouch Clips (by question) POST
Delete Vouch Clips (by question) POST