{
  "event_id": "55555555-5555-5555-5555-555555555555",
  "event_name": "visit.status_changed",
  "status": "booked",
  "changes": {
    "status": [
      "pending",
      "booked"
    ]
  },
  "visit_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-28T18:00:00Z",
  "referral": {
    "id": "22222222-2222-2222-2222-222222222222",
    "reference": "1234567890",
    "status": "pending",
    "visits": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "modality": "MRI",
        "procedures": [
          {
            "body_part": "Brain",
            "procedure": "MRI Brain w/o contrast",
            "contrast": "without_contrast",
            "laterality": "not_present",
            "cpt_code": "70551",
            "cpt_system": "http://www.ama-assn.org/go/cpt",
            "accession_id": "ACC-1001",
            "study_uid": null,
            "series_uid": null,
            "image_link": null,
            "report_link": null
          }
        ],
        "status": "booked",
        "start_time": "2026-05-28T14:00:00Z",
        "radiologist_group_name": "East Coast Radiology",
        "location": {
          "id": "11111111-1111-1111-1111-111111111111",
          "name": "Midtown Imaging Center",
          "address_line_1": "123 Main St",
          "address_line_2": "Suite 200",
          "city": "Atlanta",
          "state": "GA",
          "zip_code": "30303"
        }
      }
    ],
    "line_of_business": "personal_injury",
    "payment_type": "lien",
    "incident_state": "GA",
    "referring_provider": "Dr. Jane Smith",
    "provider": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Dr. Jane Smith",
      "npi": "1234567890"
    },
    "law_firm": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Acme LLP"
    },
    "practice": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Peachtree Family Practice"
    },
    "icd10_codes": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "code": "M54.5",
        "system": "http://hl7.org/fhir/sid/icd-10-cm",
        "short_description": "Low back pain"
      }
    ],
    "patient": {
      "id": "33333333-3333-3333-3333-333333333333",
      "identifier": {
        "system": "https://scan.com/fhir/sid/patient-id",
        "value": "33333333-3333-3333-3333-333333333333"
      },
      "name": "Alex Patient",
      "first_name": "Alex",
      "last_name": "Patient",
      "date_of_birth": "05/21/1988",
      "date_of_birth_iso": "1988-05-21",
      "email": "[email protected]",
      "phone_number": "5551234567",
      "gender": "male",
      "address_line_1": "123 Main St",
      "city": "Anytown",
      "state": "GA",
      "zip_code": "30303"
    },
    "call_notes": [
      {
        "created_at": "2026-05-27T10:30:00Z",
        "notes": "Patient confirmed appointment window."
      }
    ]
  }
}

Referral status

Status changed

Scan.com sends an HTTP POST to the webhook_url on your api_credentials record when a visit status changes. Your endpoint must accept JSON and return HTTP 2xx.

Request headers

Header	Value
Content-Type	application/json
User-Agent	Scan.com-Webhook/1.0
X-Scan-Event	visit.status_changed
X-Scan-Timestamp	Unix timestamp used in the signature
X-Scan-Signature	`v1=` followed by the HMAC-SHA256 digest

Verify the signature by computing HMAC-SHA256 with your signing secret over "{timestamp}.{raw_body}", using the exact request bytes.

WEBHOOK

statusChanged

{
  "event_id": "55555555-5555-5555-5555-555555555555",
  "event_name": "visit.status_changed",
  "status": "booked",
  "changes": {
    "status": [
      "pending",
      "booked"
    ]
  },
  "visit_id": "11111111-1111-1111-1111-111111111111",
  "occurred_at": "2026-05-28T18:00:00Z",
  "referral": {
    "id": "22222222-2222-2222-2222-222222222222",
    "reference": "1234567890",
    "status": "pending",
    "visits": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "modality": "MRI",
        "procedures": [
          {
            "body_part": "Brain",
            "procedure": "MRI Brain w/o contrast",
            "contrast": "without_contrast",
            "laterality": "not_present",
            "cpt_code": "70551",
            "cpt_system": "http://www.ama-assn.org/go/cpt",
            "accession_id": "ACC-1001",
            "study_uid": null,
            "series_uid": null,
            "image_link": null,
            "report_link": null
          }
        ],
        "status": "booked",
        "start_time": "2026-05-28T14:00:00Z",
        "radiologist_group_name": "East Coast Radiology",
        "location": {
          "id": "11111111-1111-1111-1111-111111111111",
          "name": "Midtown Imaging Center",
          "address_line_1": "123 Main St",
          "address_line_2": "Suite 200",
          "city": "Atlanta",
          "state": "GA",
          "zip_code": "30303"
        }
      }
    ],
    "line_of_business": "personal_injury",
    "payment_type": "lien",
    "incident_state": "GA",
    "referring_provider": "Dr. Jane Smith",
    "provider": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Dr. Jane Smith",
      "npi": "1234567890"
    },
    "law_firm": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Acme LLP"
    },
    "practice": {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "Peachtree Family Practice"
    },
    "icd10_codes": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "code": "M54.5",
        "system": "http://hl7.org/fhir/sid/icd-10-cm",
        "short_description": "Low back pain"
      }
    ],
    "patient": {
      "id": "33333333-3333-3333-3333-333333333333",
      "identifier": {
        "system": "https://scan.com/fhir/sid/patient-id",
        "value": "33333333-3333-3333-3333-333333333333"
      },
      "name": "Alex Patient",
      "first_name": "Alex",
      "last_name": "Patient",
      "date_of_birth": "05/21/1988",
      "date_of_birth_iso": "1988-05-21",
      "email": "[email protected]",
      "phone_number": "5551234567",
      "gender": "male",
      "address_line_1": "123 Main St",
      "city": "Anytown",
      "state": "GA",
      "zip_code": "30303"
    },
    "call_notes": [
      {
        "created_at": "2026-05-27T10:30:00Z",
        "notes": "Patient confirmed appointment window."
      }
    ]
  }
}

Body

application/json

JSON POST body sent to your webhook_url

event_id

string<uuid>

required

Stable event identifier reused for every delivery retry

event_name

enum<string>

required

Webhook event identifier

Available options:

visit.status_changed

Example:

"visit.status_changed"

status

enum<string>

required

Visit status after the change. Fires on every status change, not only post-scan ones. Each value is defined in the Track referral status guide.

Available options:

pending,

pending_auth,

co_signed,

intake_sent,

ready_to_book,

contacted_for_booking,

booked,

complete,

exam_not_completed,

sent_to_rad,

report_uploaded,

qc_report_ready,

invoice_ready,

sent_to_rp,

canceled

Example:

"booked"

changes

object

required

Fields that changed on this event

Show child attributes

visit_id

string<uuid>

required

Visit that changed

Example:

"11111111-1111-1111-1111-111111111111"

occurred_at

string<date-time>

required

When the status change was committed (ISO 8601)

Example:

"2026-05-28T18:00:00Z"

referral

object

required

Referral snapshot (same shape as GET /api/v2/referrals/{id})

Show child attributes

Response

200

Your endpoint acknowledged the event

Get started

Launch

Patient journey

Referral status

Lines of business

Status changed

Body

Response