> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arlohealth.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Network Status

> Whether a specific provider or facility is in-network for the user's
plan, and with `code`, what they charge for one service, from the
insurer's published rate files. Call this FIRST for any named clinic,
brand, facility, or provider. Pass the name plus city or ZIP; an NPI
works too and is never required.

Read `billingOutlook` before quoting a number: while it is
`partitioned` or carries a `warning`, present the range and its `ask`
rather than one price. `inNetwork: false` means "not found in the
published files", never a hard out-of-network verdict. Always relay
the `disclaimer`.




## OpenAPI

````yaml api-reference/openapi.yaml POST /api/pricing/network-status
openapi: 3.1.0
info:
  title: Arlo Health MCP Server
  version: 1.0.0
  description: |
    Healthcare infrastructure for AI agents. Everything an agent needs
    to act in healthcare for its user.

    ## Overview

    This server exposes two interfaces:
    - **MCP** (Model Context Protocol) over streamable HTTP at `/` for AI agents
    - **REST API** at `/api/*` for bots, skills, and direct HTTP clients

    Both interfaces use the same tool handlers and authentication.

    ## Authentication

    OAuth 2.1 with PKCE. All `/api/*` endpoints require a Bearer token.

    Discovery endpoints (no auth required):
    - `/.well-known/oauth-protected-resource`
    - `/.well-known/oauth-authorization-server`
    - `/.well-known/mcp.json` (MCP Server Card)

    ## Service Regions

    Care is licensed by where the patient is physically located when they
    request it, so every conversation carries an ISO 3166-2 `region` code.
    Arlo currently serves California, United States (`US-CA`); an unsupported
    region is refused with `REGION_NOT_SUPPORTED`, whose payload names the
    regions Arlo serves at that moment.
  contact:
    name: Arlo Health
    url: https://arlohealth.ai
  license:
    name: Proprietary
    url: https://arlohealth.ai/tos
servers:
  - url: https://mcp.arlohealth.ai
    description: Production MCP Server
security:
  - oauth2:
      - openid
      - profile
      - email
      - offline_access
tags:
  - name: Discovery
    description: MCP and OAuth discovery endpoints (no auth required)
  - name: Profile
    description: User profile and patient information
  - name: Consultations
    description: Healthcare consultation management
  - name: Messaging
    description: Conversation messaging and media
  - name: Prescriptions
    description: Prescription orders (read-only; Photon Health fulfills them)
  - name: Health Records
    description: The user's connected insurance and health records (US)
  - name: Care Pricing
    description: Free price transparency under the user's plan (US)
  - name: Care Jobs
    description: >-
      Real-world care actions Arlo's care team executes after the patient
      approves (US)
  - name: Payment
    description: Billing and pay-per-use payment management
  - name: Webhooks
    description: Webhook registration and status
paths:
  /api/pricing/network-status:
    post:
      tags:
        - Care Pricing
      summary: Check network status
      description: |
        Whether a specific provider or facility is in-network for the user's
        plan, and with `code`, what they charge for one service, from the
        insurer's published rate files. Call this FIRST for any named clinic,
        brand, facility, or provider. Pass the name plus city or ZIP; an NPI
        works too and is never required.

        Read `billingOutlook` before quoting a number: while it is
        `partitioned` or carries a `warning`, present the range and its `ask`
        rather than one price. `inNetwork: false` means "not found in the
        published files", never a hard out-of-network verdict. Always relay
        the `disclaimer`.
      operationId: checkNetworkStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NetworkStatusInput'
      responses:
        '200':
          description: Matches with network status and, with a code, contracted rates
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '502':
          $ref: '#/components/responses/PricingUnavailable'
components:
  schemas:
    NetworkStatusInput:
      type: object
      properties:
        providerName:
          type: string
          description: >-
            Provider or facility name. Consumer brand names work. City or ZIP
            disambiguates.
        npi:
          type: string
          description: 10-digit NPI if known. Never required.
        code:
          type: string
          description: >-
            Optional catalog CPT/HCPCS code. With it, each match carries its
            contracted rate under the plan.
        limit:
          type: number
          description: Max matches (default 50, max 100)
        latitude:
          type: number
        longitude:
          type: number
        zip:
          type: string
        planHints:
          $ref: '#/components/schemas/PricingPlanHints'
        patientId:
          type: string
    PricingResponse:
      type: object
      description: |
        Self-describing. Identical to the public pricing.v1 response for the
        same route (see the Pricing API reference for every field). Read
        plan.basis before quoting anything, relay every note-style field as
        written (any key ending in Note, plus note, rateAssessment,
        statusNote, disclaimer), and answer needsMoreInfo asks.
      properties:
        disclaimer:
          type: string
        needsMoreInfo:
          type: array
          items:
            type: object
        plan:
          type: object
        supportedServices:
          type: array
          description: Present instead of prices when no usable code was given
          items:
            type: object
      additionalProperties: true
    PricingPlanHints:
      type: object
      description: |
        Insurance identifiers from the user, used when the response asks for
        them (needsMoreInfo). The plan otherwise resolves from linked
        insurance. employerName / planName upgrade range estimates to the
        exact plan's rates; groupNumber is matched for Blue Cross Blue Shield
        of IL/TX/OK/NM/MT only. Set unavailable=true when the user cannot
        provide identifiers, which stops the asks.
      properties:
        payerName:
          type: string
          description: >-
            Insurer as the user names it (Anthem, Blue Shield of California,
            UnitedHealthcare, Cigna, Aetna, any Blue Cross Blue Shield plan,
            Original Medicare). Pins another coverage when several are linked.
        employerName:
          type: string
        planName:
          type: string
        groupNumber:
          type: string
        unavailable:
          type: boolean
  responses:
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              needsAuth:
                type: boolean
    PricingUnavailable:
      description: >-
        The pricing lookup is temporarily unavailable. Tell the user and offer
        to retry shortly; never invent prices, network status, or evidence.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                description: What failed
              agentInstructions:
                type: string
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.1 with PKCE
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          tokenUrl: /oauth/token
          scopes:
            openid: OpenID Connect
            profile: User profile
            email: Email address
            offline_access: Refresh tokens

````