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

# Blend API and User Guides

> Task-focused answers for building on the Blend API and working in the Blend Dashboard — sending prescriptions, creating orders, handling exceptions, and managing prescribers, products, and reporting.

Each guide answers one question, starting with the answer. For entity definitions and the end-to-end flow, start with [Getting Started](/overview). For request and response detail, see the [API Reference](/api-reference/orders/create-an-order).

## Getting started

<CardGroup cols={2}>
  <Card title="How do I authenticate with the Blend API?" icon="key" href="/guides/authentication">
    Bearer tokens, 60-minute expiry, refresh flow
  </Card>

  <Card title="How do I create a patient, prescription, and order in one API call?" icon="layer-group" href="/guides/composite-creation">
    The composite endpoint
  </Card>

  <Card title="Can I use my own IDs instead of Blend IDs?" icon="fingerprint" href="/guides/your-own-ids">
    external\_id, sku, and product\_code
  </Card>

  <Card title="How does pagination work?" icon="list-ol" href="/guides/pagination">
    Headers, not body metadata
  </Card>

  <Card title="How do I get notified when an order ships?" icon="webhook" href="/guides/webhooks">
    Webhook and email subscriptions
  </Card>

  <Card title="How do I search across Blend?" icon="magnifying-glass" href="/guides/search">
    Orders, patients, prescribers, products
  </Card>
</CardGroup>

## Prescriptions

<CardGroup cols={2}>
  <Card title="Can I send an electronic prescription to Blend directly?" icon="prescription" href="/guides/send-electronic-prescription">
    SCRIPT XML or JSON, non-controls
  </Card>

  <Card title="How does Blend match a prescription to a patient, product, and order?" icon="diagram-project" href="/guides/prescription-matching">
    The matching rules, in order
  </Card>

  <Card title="How do I find orders that are missing prescriptions?" icon="link-slash" href="/guides/orders-missing-prescriptions">
    has\_unmatched\_prescriptions
  </Card>

  <Card title="Why can't Blend find a prescription I sent?" icon="magnifying-glass-minus" href="/guides/find-a-missing-prescription">
    Typical mismatches and how they clear
  </Card>

  <Card title="What is refill risk?" icon="calendar-check" href="/guides/refill-risk">
    License coverage vs next fill
  </Card>
</CardGroup>

## Patients

<CardGroup cols={2}>
  <Card title="How do I create a patient?" icon="user-plus" href="/guides/create-a-patient">
    Required fields and duplicate handling
  </Card>

  <Card title="How do I record allergies, conditions, and medications?" icon="notes-medical" href="/guides/patient-risk-factors">
    Freeform risk factors
  </Card>

  <Card title="How does patient messaging work?" icon="comments" href="/guides/patient-messaging">
    Inboxes, routing, and replies
  </Card>
</CardGroup>

## Orders

<CardGroup cols={2}>
  <Card title="Why did my new order merge into an existing one?" icon="code-merge" href="/guides/order-merging">
    Merging and force\_new
  </Card>

  <Card title="How do I edit an order after it's created?" icon="pen" href="/guides/edit-an-order">
    Two different editing windows
  </Card>

  <Card title="How do I choose carrier and service level?" icon="truck" href="/guides/shipping-preferences">
    Shipping and signature confirmation
  </Card>

  <Card title="How do I cancel an order?" icon="ban" href="/guides/cancel-an-order">
    Cancel vs request cancellation
  </Card>

  <Card title="How do I pause an order?" icon="pause" href="/guides/pause-an-order">
    Indefinite and timed holds
  </Card>

  <Card title="How do I request a replacement order?" icon="rotate" href="/guides/replacement-orders">
    Doesn't consume a fill
  </Card>

  <Card title="Why is my order stuck?" icon="triangle-exclamation" href="/guides/stuck-orders">
    Exceptions and what clears them
  </Card>

  <Card title="What do Blend's order statuses mean?" icon="list-check" href="/guides/order-statuses">
    All nine, and what each allows
  </Card>

  <Card title="Why doesn't my order quantity match the prescribed quantity?" icon="scale-balanced" href="/guides/order-quantities">
    Set quantity on every line
  </Card>
</CardGroup>

## Prescribers

<CardGroup cols={2}>
  <Card title="How do I add a prescriber?" icon="user-doctor" href="/guides/add-a-prescriber">
    Required fields, NPI deduplication
  </Card>

  <Card title="How do I keep state licenses current?" icon="id-card" href="/guides/prescriber-licenses">
    Qualifications and renewals
  </Card>

  <Card title="Does Blend track license status for me?" icon="shield-check" href="/guides/prescriber-license-monitoring">
    NPI and DEA registry monitoring
  </Card>
</CardGroup>

## Products and catalog

<CardGroup cols={2}>
  <Card title="How do I reference my own products?" icon="pills" href="/guides/reference-your-products">
    id, sku, and product\_code
  </Card>

  <Card title="How do I record why a compound was needed?" icon="clipboard-list" href="/guides/compounding-reasons">
    Compounding reasons
  </Card>
</CardGroup>

## Reporting and operations

<CardGroup cols={2}>
  <Card title="What reports can I pull from the API?" icon="chart-simple" href="/guides/reports">
    Daily and orders reports
  </Card>

  <Card title="What's in the Metrics report?" icon="chart-line" href="/guides/metrics-report">
    Six sections, brand roll-ups
  </Card>

  <Card title="Can Blend support multiple brands and locations?" icon="sitemap" href="/guides/multitenancy">
    Brand, customer, location
  </Card>

  <Card title="How do I transfer a prescription out?" icon="right-left" href="/guides/transfer-out">
    The receiving pharmacy requests it
  </Card>
</CardGroup>