Certified Translation: Order a job, or get the offer: the price and the exact next call.

`order_certified_translation`

POST /jobs

A translated document with its certificate. $189 per job, within 3 days, charged on delivery. A sworn translator in the job's country signs before the certify step.

Parameters

servicestringrequired

The Service to order: "certified-translation".

documentobject · filerequired

Show 2 child keys

urlstring · urirequired

namestringrequired

tostring · languagerequired

such as fr

countrystring · jurisdictionrequired

such as FR

Left out, the 400 names it as the field to fill.

max_usdnumber

The most you will pay, in dollars. Missing or below the price, you get an offer instead of a job.

keystring

Any string you choose. Retrying with the same key returns the same job.

metadataobject

Your own keys, echoed on the job and its events.

test_clockstring

A test clock the job runs on: tc_….

Returns

Request

$ npx services.dev certified-translation document=document.pdf to=fr country=FR service=certified-translation
OFFER · $189 per job, within 3 days, charged on delivery.
  next    npx services.dev certified-translation document=document.pdf to=fr country=FR --max 189

$ npx services.dev certified-translation document=document.pdf to=fr country=FR --max 189
job_7Hq3 · working · $189.00 held

curl http://localhost:8787/jobs \
  -H 'content-type: application/json' \
  -d '{"service":"certified-translation","document":{"url":"https://example.com/document.pdf","name":"document.pdf"},"to":"fr","country":"FR","max_usd":189,"key":"any-string-you-choose"}'

→ tools/call order_certified_translation {"document":{"url":"https://example.com/document.pdf","name":"document.pdf"},"to":"fr","country":"FR","max_usd":189,"key":"certified-translation-1"}
← job_7Hq3 · working · $189.00 held

import { connect } from 'services.dev/agent'

const lingua = connect('http://localhost:8787', { budget: 189 })
const job = await lingua.order('certified-translation', {"document":{"url":"https://example.com/document.pdf","name":"document.pdf"},"to":"fr","country":"FR"}, { key: 'certified-translation-1' })

Response

{
  "id": "job_7Hq3",
  "object": "job",
  "created": "2026-10-25T14:00:24.000Z",
  "livemode": false,
  "simulated": true,
  "service": "certified-translation",
  "input": {
    "document": {
      "url": "https://example.com/document.pdf",
      "name": "document.pdf"
    },
    "to": "fr",
    "country": "FR"
  },
  "metadata": {},
  "price": {
    "usd": 189,
    "approved": false,
    "max_usd": 189
  },
  "payment": {
    "status": "held",
    "amount_usd": 189
  },
  "human": "A sworn translator in the job's country signs before the certify step.",
  "stage": null,
  "steps": [
    {
      "id": "stp_1",
      "object": "step",
      "step": "translate",
      "by": "service",
      "status": "working"
    },
    {
      "id": "stp_2",
      "object": "step",
      "step": "review",
      "by": "ai",
      "review": "adversarial",
      "status": "pending"
    },
    {
      "id": "stp_4",
      "object": "step",
      "step": "certify",
      "by": "ai",
      "status": "pending"
    }
  ],
  "next": [
    {
      "do": "get",
      "arguments": {
        "id": "job_7Hq3"
      },
      "tool": "get_job",
      "http": "GET http://localhost:8787/jobs/job_7Hq3?wait=50"
    },
    {
      "do": "cancel",
      "arguments": {
        "id": "job_7Hq3"
      },
      "tool": "cancel_job",
      "http": "POST http://localhost:8787/jobs/job_7Hq3/cancel"
    }
  ],
  "status": "working"
}

job_7Hq3 · working · $189.00 held

captured at build · dev() seed 7Hq2 · services.dev 0.3.0