Find availability

Input

• provideranyRequired

  Whose openings to ask about.

• patient_relationshipenumRequired

  New or established patient.

  Possible values

  • newHas not seen this provider or practice in three years.
  • establishedHas seen them in the last three years.
• reasonstring

  Openings differ by visit type. Up to 500 characters.

• insurance_planobject

  Ask whether the office takes it.

  Show child parameters

  • payer_namestringRequired

    Such as Aetna. Up to 255 characters.

  • plan_namestring

    Such as Aetna Choice POS II. Up to 255 characters.

Returns

The action, with this result once it ends.

• summarystring

  What happened, in a sentence or two. Up to 2,000 characters.

• failure_reasonenum, nullable

  Why it failed. Null unless failed.

  Possible values

  • patient_authorization_requiredThe place needs the patient herself to authorize it.
  • place_would_not_helpThe place would not discuss it with Vene.
  • place_unreachableClosed, never answered, or no working number.
  • declined_by_youYou declined something the action needed.
  • fee_over_maxThe fee was over max_fee. The result names it.
  • internal_errorA Vene fault.
• next_stepstring, nullable

  What you could do next. Up to 1,000 characters.

• accepting_new_patientsboolean, nullable

  Null when the office would not say.

• accepts_insurance_planboolean, nullable

  Null when not asked or not said.

• openingsarray of objects

  Soonest first. Up to 10 items.

  Show child parameters

  • starts_attimestamp
  • duration_minutesinteger

    1 to 1,440.

  • providerobject
    Show child parameters

    • first_namestring

      The clinician's first name. Up to 120 characters.

    • last_namestring

      The clinician's last name. Up to 120 characters.

    • credentialstring

      Such as MD or NP. Up to 32 characters.

    • npistring

      The clinician's NPI. The surest way to find the office. 10 digits.

    • specialtystring

      Such as cardiology. Up to 120 characters.

    • practiceobject

      Where the patient is seen.

      Show child parameters

      • namestring

        Such as Oakland Heart Center. Up to 255 characters.

      • addressobject
        Show child parameters

        • line1string

          Street address. Up to 255 characters.

        • line2string

          Suite or unit. Up to 255 characters.

        • citystring

          Up to 120 characters.

        • statestring

          Such as CA. Two-letter state code.

        • postal_codestring

          Five-digit ZIP code. 5 digits.

      • phonestring

        A hint. Vene checks the number before it dials. E.164 phone number.

  • locationobject
    Show child parameters

    • line1string

      Street address. Up to 255 characters.

    • line2string

      Suite or unit. Up to 255 characters.

    • citystring

      Up to 120 characters.

    • statestring

      Such as CA. Two-letter state code.

    • postal_codestring

      Five-digit ZIP code. 5 digits.

Questions

inputtextnumberbooleandatechoice

How to answer them

Calls

ask_provider_availability

Errors

• 400invalid_request

  The body or query failed validation.

• 401unauthorized

  The API key is missing, unknown, or revoked.

• 403forbidden

  The key lacks the scope.

• 409idempotency_conflict

  The key was used with a different body.

• 429rate_limited

  Over a limit. Wait for Retry-After.

• 500internal_error

  A Vene fault.