1. User guide
  2. Advanced Features

Creating and Checking Projects via API

We developed a set of Rest APIs to let you integrate Matecat into your translation management system or any other application. Use our APIs to create projects and check their status.
As all REST services are HTTP calls, in particular, in our case you can use GET, POST, and DELETE.
You can create or check your projects through APIs, so you can automate and optimize the management of this process.

In this short article, we offer a general overview of the most used APIs.

The APIs provided by Matecat allow:

  • the creation of a project through the HTTP POST call /new:
    create a new Project on Matecat With HTTP POST (multipart/form-data) protocol. In order to use this API you have to authenticate by adding the x-matecat-key header to the call and populate it with your API key. If you don't have an API key, visit this page to find out how to obtain one. The maximum file size is 200 MB per file and the maximum number of files is 600. Matecat accepts 80 file formats. A list of all accepted formats is available here: https://www.matecat.com/api/docs.
  • checking a project status via the HTTP HTTP GET call /status:
    check Status of a Project (ANALYZING, DONE, FAIL) With HTTP POST (application/x-www-form-urlencoded) protocol.
    With this call you can also know the project’s number (match, repetitions, mt, …) and the details of the individual job.
  • viewing a single job stats with the HTTP GET call /stats:
    lets you see how many words you are working on and how many are DRAFT, TRANSLATED, APPROVED, REJECTED, etc
  • obtaining all useful URLs with the HTTP GET call /url:
    you can have the links to perform the various actions: “Download the original”, “Download translation” and “Download the xliff”
  • viewing all comments through the HTTP GET call /comment:
    you can get all the comments about a particular job.

You can generate the API credentials on your own from the personal profile panel. 

For technical details on how to use these APIs, please find out more here: www.matecat.com/api/docs.