HomeGuidesAPI Reference
API Reference

Post a Quote Request

post
https://{access_key}:{secret}@api.tolq.com/v1/translations/requests/quote

Send the content you need to translate

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Create a quote to review content and pricing before ordering translation. Quote requests use the same JSON structure as translation requests - simply add /quote to the endpoint URL.

The Callback URL

You don't need to constantly poll for the state of translation of a translation request in order to get the approved translations as soon as possible in your system.

If you provide a callback_url in the JSON we will call back that url with the same payload as Retrieve a Translation Request.

Payment

The order will be billed to your account according to the billing information you have set up.

The order won't be made effective until you order it using the clients application or using the API.

Language Codes

All language codes have to be in ISO 639-1 format (two letters).

Body Params
string
required

Each key inside a request requires a text key with the content to translate.

string
required

The source language of the content in the order. Should contain a two-letter ISO 639-1 language code

string
required

The target language to which the content should be translated. Should contain a two-letter ISO 639-1 language code.

string
required

"machine","postediting", "translation", "localization", or "expert". The quality level in which the request will be translated.

int32
Defaults to 1

In options (see example). Clients application allows you creating different style guides for your translators you can select which one you want to use via this attribute. If no ID is provided, translators will get your default style guide.

string

In options (see example). The content of this url will be shown to translators to let them know the context in which the sentences will be used.

string

In options (see example). Max 255 characters. A name so it can be identified easily in the clients application UI

string

In options (see example). A clarification for future reference

boolean
Defaults to false

In options (see example). It's possible to skip the Client Review process. Translations will then be moved to finished state immediately.

string

In options (see example). Max 255 characters. Immediately after the translation request is reviewed and accepted we will call this url. It will contain the same payload as the one in the GET request.

string

In options (see example). The email of one of your editors. If present, the request will be assigned to that editor. In "options"

string

In options (see example). Preferred date for translation to be completed. Only used for prioritizing translation requests of the same client. Date format iso 8601

string

In options (see example). Code used by client to organize requests

Responses

Updated 12 months ago

What’s Next

Order a Quoted Request

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Choose an example:
application/json

Updated 12 months ago

What’s Next

Order a Quoted Request