Pharmacy Claims API

B2 Reversal API

Reverse previously submitted pharmacy claims with a single POST request. Handle returns, billing corrections, and claim adjustments, all through JSON.

When to reverse a claim

Patient returns medication

Prescription picked up but returned within allowed window

Billing error correction

Wrong quantity, days supply, or pricing submitted on the original B1

Insurance change

Patient has different coverage than originally billed. Reverse and rebill

Duplicate claim cleanup

Accidental double submission needs one copy reversed

Rebill workflow

Reverse the original, then submit a corrected B1 with updated information

Reverse a claim

terminal

curl -X POST https://starlight.claims/api/v1/submit \
  -H "X-API-Key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_type": "B2",
    "patient": {
      "first_name": "JANE",
      "last_name": "DOE",
      "date_of_birth": "19850115",
      "gender": "F",
      "zip_code": "12345"
    },
    "insurance": {
      "bin_number": "999999",
      "pcn": "TEST",
      "group_id": "GRP999999",
      "cardholder_id": "SAMPLE123456"
    },
    "prescription": {
      "rx_number": "999000001234",
      "product_id": "00000000000",
      "quantity_dispensed": "28",
      "days_supply": "28"
    }
  }'

Response

{
  "status": "Accepted",
  "message": "Claim reversed successfully",
  "original_claim_id": "CLM_20260101120000_abc12345"
}

The reversal → rebill pattern

The most common B2 workflow is reverse and rebill: reverse the original claim, then immediately submit a corrected B1 with updated information.

1Submit B2 reversal with original claim details

2Verify reversal accepted in response

3Submit corrected B1 with updated fields

B1 vs B2: what changes

›transaction_type changes from "B1" to "B2"
›Patient, insurance, and prescription fields must match the original B1 exactly
›Pricing fields should match the original submission
›The PBM matches the reversal to the original claim and unwinds the adjudication

Need to reverse a claim?

Same API, same simplicity. B2 reversals work exactly like B1 submissions.

Get Started Read Docs