PTC API Reference

The PTC API uses REST and allows you to integrate software localization into your development process. The API endpoints let you add and update source files, retrieve information, manage translations, and more.

The PTC API can be used in live mode only. It supports standard HTTP methods and returns JSON-formatted responses. Authentication is token-based and project-specific.

Code Snippets

Ruby

Python

PHP

Java

Go

.NET

Node.js

JavaScript (jQuery)

The documentation uses cURL to show how to make HTTP requests to the PTC API, but you can switch to see different examples in code.

Authentication

Creating API tokens is a Pro feature. It becomes available when you activate Pay-As-You-Go.

To get started:

1. Log into your PTC account. If you don’t have one yet, start a free trial and upload your first file manually.
2. To move an existing project to API integration, go to Settings → Manage API Tokens and add an access token. For subsequent projects, you can select API integration in the setup wizard.

All requests to the PTC API require authentication using a token that gives you access to a single project in PTC.

Include the token in the Authorization header of every request using the Bearer format:

Bearer <AUTHENTICATION_TOKEN>

Bearer <AUTHENTICATION_TOKEN>

Response Codes

The PTC API uses standard HTTP response codes to indicate the success or failure of a request.

HTTP Status Code Summary

Rate Limiting

The PTC API implements rate limiting to ensure fair usage and maintain service quality. Limits are applied per organization and tracked across specific API operations.

Affected Endpoints

• POST /api/v1/source_files – Create the source files
• PUT /api/v1/source_files/process – Process the source files
• POST /api/v1/source_files/bulk – Upload source files in bulk

When Rate Limits Are Exceeded

If a request exceeds the allowed rate, the API returns:

Status: 429 Too Many Requests
{
  "error": "Rate limit exceeded"
}

Status: 429 Too Many Requests
{
  "error": "Rate limit exceeded"
}

Available API Categories