Skip to content
TriedDocs
Account

Get call privacy

Read the data storage setting applied to a call and how many PII items were redacted.

GEThttps://api.tried.com.au/privacy/call/{call_id}

Shows what privacy processing was applied to one call: which data storage setting was used, when it ran, and how many items of each PII category were redacted. Use it to confirm that a call handled under everything_except_pii or basic_attributes_only was scrubbed.

Request#

Path parameter Type Description
call_id string The call ID, for example call_7b1d3f5a9c2e4b6d8f0a1c3e.

Example request#

curl https://api.tried.com.au/privacy/call/call_7b1d3f5a9c2e4b6d8f0a1c3e \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch(
  "https://api.tried.com.au/privacy/call/call_7b1d3f5a9c2e4b6d8f0a1c3e",
  { headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` } },
);
const privacy = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/privacy/call/call_7b1d3f5a9c2e4b6d8f0a1c3e",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
privacy = res.json()

Response#

200 OK

{
  "call_id": "call_7b1d3f5a9c2e4b6d8f0a1c3e",
  "data_storage_setting": "everything_except_pii",
  "applied_at": 1760918275000,
  "redactions": {
    "phone_number": 2,
    "email": 1,
    "person_name": 1,
    "recording_beep": { "mixed": "beeped", "dual": "nothing_to_beep" }
  },
  "recording_url_ttl_s": 3600
}
Field Type Description
data_storage_setting string or null everything, everything_except_pii or basic_attributes_only. null when no privacy processing was recorded for the call, which is the case for calls stored with everything by default.
applied_at integer or null When the scrub ran, Unix ms. null if it has not run yet (it runs after the call's webhooks and analysis).
redactions object Count of redacted items per PII category: person_name, address, email, phone_number, ssn, passport, driver_license, credit_card, bank_account, password, pin, medical_id, date_of_birth. When the call has a recording, recording_beep reports for the mixed and dual-channel files whether redacted words were beeped out: beeped, nothing_to_beep, unsupported_location, no_decoder, decode_failed or error. Empty for basic_attributes_only, which deletes the transcript and recordings instead.
recording_url_ttl_s integer or null Lifetime in seconds of signed recording URLs for this call, when signed URLs are on.

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the admin scope.
404 Call call_7b1d3f5a9c2e4b6d8f0a1c3e not found in this workspace.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.