Requests

List Requests

Retrieve requests filtered by date range or batch ID.

get/v1/requests

Request

  • Base URL: https://robodialer-service-api-9nc4t1p9.uc.gateway.dev
  • URL: https://robodialer-service-api-9nc4t1p9.uc.gateway.dev/v1/requests
  • Auth: HTTP bearer

Query parameters

dateFromstring date

Optional. Start of the dateCreated window (inclusive), YYYY-MM-DD. Interpreted as UTC midnight. When omitted (and requestBatchId is also omitted), defaults to today in the server's clock.

dateTostring date

Optional. End of the dateCreated window (exclusive), YYYY-MM-DD. Interpreted as UTC midnight. When omitted (and requestBatchId is also omitted), defaults to tomorrow in the server's clock.

requestBatchIdstring

Optional. Return every request belonging to this requestBatchId. Bypasses the dateFrom/dateTo defaults. Passing this returns matching requests regardless of when they were created.

pageSizeinteger

Optional. Turns on pagination. Maximum number of requests to return in one page (1 to 500). Omit to return every matching request in one response. A value outside the range is rejected with 400 INVALID_REQUEST.

pageTokenstring

Optional. Opaque cursor from a previous response's nextPageToken. Resumes the listing where the previous page ended. Keep the other filters unchanged across pages. Passing pageToken without pageSize applies the default page size of 100. A malformed token is rejected with 400 INVALID_REQUEST.

Response

List of requests. The list endpoint omits transcript and recordingDownloadUrl. Fetch GET /v1/requests/{requestId} for those. Every other field on RequestResponse (including state, modality, data_completeness, error) is included when applicable.

nextPageTokenstring

Present only when more pages remain, which requires pageSize (or pageToken) on the request. Pass it back as pageToken to fetch the next page. Absent on the final page.

Example response

{
  "requests": [
    {
      "requestId": "8bF7xK2mP9qR4sT6uV0w",
      "requestBatchId": "pH9kJ2lM4nB6vC8xZ7Qr",
      "schemaId": "fWxzG4nqtpHsJxS5Lm3q",
      "requestType": "claim-status",
      "state": "SUCCESS",
      "inputs": {
        "payerName": "Sample Insurance Co",
        "memberId": "TEST123456789",
        "providerNpi": "1234567890",
        "phoneNumber": "2125551234",
        "dateOfService": "2026-03-15"
      },
      "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_456",
      "internalTag": "march-batch",
      "modality": "phone_only",
      "data_completeness": null,
      "error": null,
      "payerLookup": {
        "inputPayerName": "Sample Insurance Co",
        "inputPhoneNumber": "2125551234",
        "matchedPayerName": null,
        "matchedPayerPhone": null,
        "phoneNumberToUse": "2125551234",
        "phoneNumberSource": "input"
      },
      "to": "+12125551234",
      "transcript": "SuperDial Agent: Hi, I'm calling to check on a claim status.\nRepresentative: Sure, can I get the claim number?...",
      "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.",
      "callSteps": [
        {
          "key": "claim-status",
          "schemaId": "fWxzG4nqtpHsJxS5Lm3q",
          "name": "Claim Status",
          "state": "SUCCESS",
          "fieldsRequired": 4,
          "fieldsCaptured": 4,
          "missingFields": [],
          "numContributingCalls": 1,
          "triggeredBy": null
        }
      ],
      "contributingCalls": [
        {
          "id": "9nQ4vT7xB2mK5pR8sL0w",
          "call": 1,
          "callStep": "claim-status",
          "fieldsCaptured": [
            "claimStatus",
            "paidAmount",
            "checkNumber",
            "paidDate"
          ],
          "results": {
            "claimStatus": "PAID",
            "paidAmount": "150.00",
            "checkNumber": "CHK998877",
            "paidDate": "2026-04-10"
          },
          "completedAt": "2026-04-24T15:32:18.987654+00:00"
        }
      ],
      "resultSources": {
        "claimStatus": 1,
        "paidAmount": 1,
        "checkNumber": 1,
        "paidDate": 1
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.