Skip to main content
Payer-phone resolution is an opt-in capability your account team enables. When it’s on, you can submit a request with a payerName but no phoneNumber, and SuperDial will look up the dialing number for you. When it’s off, every request must supply phoneNumber directly.
Resolution is off by default. Ask your account team if you’d like it turned on. Without it, the rest of this page doesn’t apply — phoneNumber stays in requiredInputs.fields and you supply it on every request.

​
How it works

With resolution enabled on your account:
What you send in inputsWhat happens
payerName onlySuperDial looks up the dialing number. The matched payer comes back on the response under payerLookup.
payerName + phoneNumberYour phone number is used as-is. No lookup runs.
NeitherNo lookup.

​
Latency

Resolution runs synchronously inside the POST /v1/requests handler, so expect the response to take about 15 seconds when resolution is happening. Set your HTTP-client timeout accordingly (≥30s is safe). Requests that supply phoneNumber skip this path and return in well under a second.

​
The response

When lookup runs successfully, the POST /v1/requests response includes: 
{
  "requestId": "8bF7xK2mP9qR4sT6uV0w",
  "requestBatchId": "pH9kJ2lM4nB6vC8xZ7Qr",
  "internalId": "claim_internal_456",
  "payerLookup": {
    "inputPayerName": "Sample Insurance Co",
    "matchedPayerName": "Sample Insurance Company, Inc."
  }
}
inputPayerName is what you sent. matchedPayerName is the canonical payer SuperDial matched. Compare the two names if you want to confirm we matched the right payer. The resolved phone number is not returned: dialing happens server-side and the number is never echoed back to clients. The payerLookup block also appears on the read endpoints (GET /v1/requests and GET /v1/requests/{requestId}), so you can read the matched payer back later rather than having to capture it from the POST response.

​
Tips

  • Include memberId for Blue Cross Blue Shield (BCBS) lookups. It affects which regional plan gets dialed.
  • You don’t need an exact-string match. Common variants and acronyms (e.g. "BCBS", "BCBSMA", "Blue Cross Blue Shield") all work.
  • Supply phoneNumber to skip resolution. Useful when you already know the number, or when you want to dial a specific number regardless of what resolution would pick.

​
When resolution fails

HTTPerror codeWhat to do
400PAYER_NOT_FOUNDThe name didn’t match any payer. Try a more canonical spelling, or supply phoneNumber directly.
500PAYER_LOOKUP_FAILUREWe matched a payer but couldn’t get a phone number, or a temporary lookup error. Retry with backoff, or supply phoneNumber directly.
The message field describes what went wrong.