TRACE API
Connect TRACE to the programs you already use.
Read your technicians, certifications, compliance deadlines, jobs, reports and records from another program — and, if your safety or HR system already holds the records, keep TRACE in step with it.
Every endpoint, field and answer: the OpenAPI description (/api/v1/openapi.json)
How a call travels
Your key, your records, nothing else.
1. Make a key
The API comes with the Plus, Pro and Enterprise plans. An account that has bought a single module on its own is not one of those, so it cannot make a key either. Your firm's primary contact makes keys in TRACE under Account → Integrations & data → API. Give the key a name, tick only what the other program needs (reading is per record type; writing is off unless you tick it), and optionally set an expiry and the addresses it may call from. The key is shown once — copy it then. TRACE keeps only a scrambled fingerprint of it, so nobody can show it to you again; if it is lost, revoke it and make another. Revoking takes effect on the next call.
2. Call an endpoint
Send the key in the Authorization header. Every answer is JSON.
curl https://www.tracendt.com/api/v1/technicians \
-H "Authorization: Bearer trc_ab12cd34ef_…"GET /api/v1/me tells you which key you are using, for which firm, and what it may do.
3. Page through a list
Lists come back 100 records at a time (ask for up to 200 with ?limit=), oldest id first. Each page says whether there is another. Keep asking with the cursor it gives you until has_more is false — a list is never cut short without saying so.
{ "data": [ … ], "has_more": true, "next_cursor": "5f0c…" }
GET /api/v1/technicians?cursor=5f0c…Documents come with a link to the file that works for five minutes; field reports with a link to their PDF that works for ten. Ask again for a fresh link.
4. Handle the rate limit
Each key may make 600 calls every 15 minutes. Past that, TRACE answers 429 with a Retry-After header in seconds — wait that long and carry on. If a regular sync needs more, ask us and we can raise a key's limit.
5. Keep TRACE in step with your safety or HR system
If your firm already keeps safety or HR records elsewhere, your primary contact can mark that module under Account → Modules → Modules in Another Tool. TRACE then hides the module's menu, dashboard cards and reminders; nothing is deleted, and your bill does not change. Then send records in with a key that has write permission. Each write is keyed on your system's id, so sending the same record again updates it rather than making a copy:
curl -X POST https://www.tracendt.com/api/v1/safety/trainings \
-H "Authorization: Bearer trc_ab12cd34ef_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7d2e…" \
-d '{"external_source": "safety-system", "external_id": "TR-1001",
"fields": {"training_type": "Radiation Safety", "completed_on": "2026-09-01"},
"refs": {"technician_external_id": "EMP-42"}}'- A new record answers
201, an update200. Send technicians first; later records can name them by your id (technician_external_id) or by TRACE's. - TRACE checks each record the way its own forms do. Anything it cannot accept answers
422with a list ofproblems. - A record that has been signed or reviewed in TRACE is final: a write to it answers
409, and it changes only by a revision made in TRACE. - An
Idempotency-Keyheader is optional. A retry with the same key and body within a day gets the first answer back instead of acting twice.
6. Hear when a deal or estimate changes
With the Clients or Ledger add-on, your primary contact can add up to 10 webhook endpoints under Account → Integrations & data → Webhooks. Give an https:// address on the public internet and tick what to be told about. TRACE then sends a POST with a JSON body each time it happens (the deal events need Clients; the estimate events come with either add-on):
deal.created— a deal is createddeal.stage_changed— a deal moves to another stagedeal.won— a deal is wondeal.lost— a deal is lostestimate.created— an estimate is createdestimate.status_changed— an estimate's status changesestimate.accepted— an estimate is acceptedestimate.declined— an estimate is declined
{ "id": "9b1e…", "type": "deal.won", "created_at": "2026-11-21T15:04:05Z",
"data": { "object": "deal", "id": "5f0c…", "stage": "Closed Won", "stage_kind": "won", …,
"changes": { "stage": { "from": "Proposal", "to": "Closed Won" } } } }- A message carries the record's ids, its plain fields and what changed. It never carries an estimate's customer link. Read the full record with an API key if you need more.
- Every message has a
TRACE-Signatureheader,t=<unix seconds>,v1=<signature>. The signature is an HMAC-SHA256, keyed with the endpoint's signing secret (shown once, when you add it), overt, a full stop, and the exact body. Compute it yourself, compare in constant time, and refuse atmore than 5 minutes from your clock. TRACE-Eventnames the event andTRACE-Deliverythe message; the body'sidis the same on every try, so use it to ignore a repeat.- Answer with any
2xxwithin ten seconds. Anything else, a redirect included, is tried again later, 6 times in all over about a day. After 20 failed tries in a row the endpoint is turned off, and the Webhooks page says why. The page lists the last 30 days of messages and how each went. - Messages usually leave within a minute of the change; a retry, or anything that missed, goes with the hourly pass. The shared demo workspace never sends.
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const want = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(want), Buffer.from(v1)) && Math.abs(nowInSeconds - t) < 300;What you can reach
| Path | Records | Can write |
|---|---|---|
/api/v1/technicians | Technicians | Yes |
/api/v1/certifications | Certifications | Yes |
/api/v1/compliance-items | Compliance items | Read only |
/api/v1/companies | Companies | Read only |
/api/v1/jobs | Jobs (Projects add-on) | Read only |
/api/v1/field-reports | Field reports (Projects add-on) | Read only |
/api/v1/documents | Documents | Read only |
/api/v1/safety/trainings | Safety trainings (Safety add-on) | Yes |
/api/v1/safety/dosimetry | Dosimetry readings (Safety add-on) | Yes |
/api/v1/safety/sources | Source inventory (Safety add-on) | Yes |
/api/v1/safety/source-log | Source log (Safety add-on) | Yes |
/api/v1/safety/jsas | Job safety analyses (Safety add-on) | Yes |
/api/v1/hr/credentials | People credentials (People add-on) | Yes |
/api/v1/hr/screenings | Medical and screening records (People add-on) | Yes |
/api/v1/certifications/vision-exams | Vision exams | Yes |
/api/v1/hr/time-off | Time off (People add-on) | Yes |
/api/v1/crm/deals | Deals (Clients add-on) | Read only |
/api/v1/crm/stages | Deal stages (Clients add-on) | Read only |
/api/v1/crm/contacts | CRM contacts (Clients add-on) | Read only |
/api/v1/crm/companies | CRM companies (Clients add-on) | Read only |
/api/v1/crm/estimates | Estimates (Clients or Ledger add-on) | Read only |
Every field, type and answer is in the OpenAPI description: /api/v1/openapi.json.
How your data is protected
- A key sees only its own firm's records, and only the kinds of record it was given.
- Every call is recorded with the key, what it asked for, how many records came back and the address it came from. Unusual volume is flagged to your firm and to us.
- Every change made through the API is in your audit trail, with the key as the one who made it.
- Keys of a deactivated account are refused. The shared demo workspace cannot make keys.
- A firm that is not on Plus, Pro or Enterprise keeps its keys, but they are refused (
403 refused_plan) until it is on one of those again; then they work as before. - If a key is exposed, revoke it at once. TRACE staff can also revoke a key in an emergency — a key posted in public, say — and your firm's primary contact is emailed the reason. Staff never see a key's secret; TRACE does not have it.
More on how TRACE is secured. Using the API is covered by our Terms of Service.