Developer Portal

Reference documentation for the public Toptranslation APIs. Every API is described by an OpenAPI specification you can read, search and try out directly in the browser.

Getting started

  • Environments. Each API has a production host and a matching *.sandbox.toptranslation.com host. Use the sandbox while you integrate.
  • Authentication. Most APIs authenticate with an access token sent in the Authorization: Bearer <token> header. The Base API uses an OAuth 2.0 access token (manage tokens in the client dashboard or request one when registering your application); the Info Service is public.
  • Format & conventions. All requests use HTTPS and responses are JSON. Timestamps are ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) and locales use ISO 639 codes (see the Base API /locales endpoint).
  • Uploading files. Documents are stored by the File Service. Upload a file there first to receive a document_token, then create the document in the Base API (e.g. on an order) using that token.
  • Pick an API below to open its full interactive reference, including request examples and a built-in “try it” client.