> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/origin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/origin/apis-all/captions-and-translations-api-docs.md).

# Captions and Translations API Docs

General Information

By using Origin Nexus's [Captions and Translations API](broken://pages/553ee14dd234811e0bf13edc8f6f4809ae26c87f), you can easily offer captions for the hearing impaired on Origin Nexus's video assets. With the captions, you can also have them translated through our partners at Rev.com and localize the videos by language. To get started, you will have to set up your account with Rev.com and then you can order the videos that you want captioned and translated to reach your diverse audience.

Before you begin:

1. Sign up for an account at Rev.com .
2. Request API Access. They will ask you to set up invoicing with them in order to enable access.
3. Once approved, Rev.com support will send you Sandbox Keys for testing.
4. Use the Sandbox Client and User Keys to test the /Rev/Order API.
5. Request Production Keys from Rev.com support.

### Usage&#xD;<br>

* Transcriptions - Sentiment analysis, keyword extraction, translations, Phrases.
* Translations - Use the transcription to translate into multiple languages for caption localization.
* Captions - Localization, ADA compliance.

### Example&#xD;<br>

Once you have API access to Rev.com you will be able to use your Rev.com Client and User API keys to send videos from IVA.

**/Rev/Orders** <br>

#### Usage and SDK Samples&#xD;<br>

`curl -v -X POST"https://ee.iva-api.com/Rev/Orders" -H "accept: application/json" -H "Ocp-Apim-Subscription-Key: [[apiKey]]" -H "Content-Type: application/x-www-form-urlencoded" -d "ClientApiKey=[[ClientKey]]&UserApiKey[[UserKey]]&VideoId=[[VideoId]]&UseSandbox=true"`

### FAQ&#xD;<br>

*If I request a notification what can I expect to be returned?*

* When the order is complete or cancelled, IVA returns a JSON object that contains the Id for the caption and the Status. Example: { "id":4, "status": “Complete” } or { "id":6, "status": "Cancelled"}.

**Is the ReferenceId in Entertainment Express the same as client\_ref in Rev?**

* No. The ReferenceId in EE only lives inside IVA. Not on Rev. The Id for the caption is used in the client\_ref in Rev.

**Can I get detailed status updates like in Rev?**

* Not currently. IVA waits for the job to be complete and when we receive notification from Rev we process and send notification to the client. Considering adding this at a future date.