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 |
Link
| 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 |