Skip to main content
GET
/
v1
/
requests
/
{requestId}
Retrieve a Request
curl --request GET \
  --url https://robodialer-service-api-9nc4t1p9.uc.gateway.dev/v1/requests/{requestId} \
  --header 'Authorization: Bearer <token>'
{
  "requestId": "8bF7xK2mP9qR4sT6uV0w",
  "requestBatchId": "pH9kJ2lM4nB6vC8xZ7Qr",
  "schemaId": "fWxzG4nqtpHsJxS5Lm3q",
  "requestType": "claim-status",
  "state": "SUCCESS",
  "inputs": {
    "payerName": "Sample Insurance Co",
    "memberId": "TEST123456789",
    "patientFirstName": "Sample",
    "patientLastName": "Patient",
    "patientDateOfBirth": "1990-01-15",
    "beginningDateOfService": "2026-03-15",
    "billingProviderName": "Test Clinic LLC",
    "billingProviderTaxId": "999999999",
    "renderingProviderName": "Dr Test Provider",
    "renderingProviderNpi": "1234567890",
    "claimChargeAmount": "150.00",
    "phoneNumber": "2125551234"
  },
  "results": {
    "claimStatus": "PAID",
    "paidAmount": "150.00",
    "checkNumber": "CHK998877",
    "paidDate": "2026-04-10"
  },
  "missingFields": [],
  "dateCreated": "2026-04-24T15:30:00.123456+00:00",
  "completedAt": "2026-04-24T15:32:18.987654+00:00",
  "dueDate": "2026-04-25T23:00:00+00:00",
  "internalId": "claim_internal_001",
  "internalTag": "march-batch",
  "modality": "phone_only",
  "data_completeness": null,
  "error": null,
  "to": "+12125551234",
  "transcript": "SuperDial Agent: Hi, I'm calling to check on a claim status for member TEST123456789.\nRepresentative: Let me look that up for you...",
  "recordingDownloadUrl": "https://storage.googleapis.com/sd-recordings/.../recording.mp3?X-Goog-Signature=...",
  "callDuration": "00:08:42",
  "callSummary": "Verified claim status as PAID. Check #CHK998877 issued on 2026-04-10 for $150.00.",
  "callAuditSummary": "All claim status questions answered. Representative confirmed paid amount and check number."
}

Authorizations

​
Authorization
string
header
required

Bearer token obtained from the /v1/auth endpoint

Path Parameters

​
requestId
string
required

The request ID

Response

Request retrieved successfully. Single-request reads include phone-call enrichment fields (transcript, recordingDownloadUrl, etc.) when a representative call has completed.

​
requestId
string
​
requestBatchId
string
​
schemaId
string
​
requestType
string
​
state
enum<string>

Request lifecycle state (uppercase). See State for what each value means and which response fields are populated for it.

Available options:
PROCESSING,
SUCCESS,
PARTIAL,
FAILURE
​
inputs
object
​
results
object

Structured request output fields. Empty {} on PROCESSING and FAILURE; partially populated on PARTIAL; fully populated on SUCCESS.

​
missingFields
string[]

Schema fields the request was unable to obtain. Populated on PARTIAL and FAILURE requests where extraction ran but came up short.

​
dateCreated
string<date-time> | null

Time the request was created, ISO-8601 with UTC offset (e.g. "2026-04-24T15:30:00.123456+00:00").

​
completedAt
string<date-time> | null

Time the request reached a terminal state (SUCCESS, PARTIAL, or FAILURE). null while the request is still PROCESSING.

​
dueDate
string<date-time> | null

Date this request is scheduled to run, as an ISO-8601 timestamp (e.g. "2026-05-08T03:00:00+00:00"). Set at submission time based on your account's daily call capacity and any work already pending. null when no due date is set.

​
internalId
string | null

Optional. Echoed back from the request body if you supplied one at create time. The key is always present in this response (as null when not supplied), unlike on webhook payloads where the key is omitted entirely.

​
internalTag
string | null

Optional. Echoed back from the request body if you supplied one at create time. The key is always present in this response (as null when not supplied), unlike on webhook payloads where the key is omitted entirely.

​
modality
enum<string> | null

How the result was obtained. See Modality for the value semantics. phone_only and digital_plus_phone both mean a phone call was placed (billable at the phone-call rate); digital_only means no phone call.

Available options:
digital_only,
phone_only,
digital_plus_phone
​
data_completeness
enum<string> | null

Completeness tier of a digital-only result. See data_completeness for current and reserved values.

Available options:
minimum
​
error
object

Structured error details. Populated on PARTIAL and FAILURE; null on PROCESSING and SUCCESS. See error object for the schema and the full errorCode taxonomy.

​
payerLookup
object

Payer-phone lookup echo (inputPayerName / matchedPayerName, phone omitted). Present whenever a payer name was supplied or matched for this request; absent/null otherwise. Mirrors the block returned on the POST /v1/requests create response.

​
to
string

The phone number that was dialed, echoed back in sanitized form. Present only when a representative phone call has completed (any terminal state) and the number was one you supplied in inputs.phoneNumber. When the number came from payer-phone resolution, to is omitted — the matched payer is surfaced via payerLookup instead (without a phone number).

​
transcript
string

Full call transcript. Present only when a representative phone call has completed.

​
transcriptPostCall
string

Optional. Post-call transcript. Present only when a phone call has completed AND your account has post-call transcripts enabled. Contact your account team to turn this on.

​
recordingDownloadUrl
string

Signed URL for the call recording. Present only when a phone call has completed and a recording exists.

​
callDuration
string

Call duration in HH:MM:SS format. Present only when a phone call has completed and recording length data exists.

​
callFromNumber
string

Optional. Outbound caller number (E.164) — the line the call originated from. Present only when a phone call has completed AND your account has outbound-number visibility enabled. Contact your account team to turn this on.

​
callSummary
string

AI-generated call summary. Present only when a representative phone call has completed.

​
callAuditSummary
string

AI-generated audit summary. Present only when a representative phone call has completed.

​
contributingCalls
object[] | null

Per-call breakdown for requests that took more than one phone call. Present only on the single-request read (GET /v1/requests/{requestId}) of a SUCCESS request completed across two or more representative phone calls. Omitted otherwise.