---
title: "List Stripe invoice reconciliation events"
method: GET
path: "/admin/billing/stripe/invoice-events"
tags: ["Billing"]
---

# List Stripe invoice reconciliation events

`GET /admin/billing/stripe/invoice-events`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stripe/invoice-events`
- Auth: API key in header `x-api-key`

Admin-only endpoint that lists local Stripe invoice webhook audit events used to reconcile Stripe invoice lifecycle back to billing period ledgers.

## Query parameters

- `status` 'matched' | 'unmatched'
- `customer_id` string
- `invoice_id` string
- `repair_status` 'pending' | 'running' | 'succeeded' | 'failed' | 'skipped'
- `repair_source` 'webhook_auto' | 'admin_manual'
- `min_repair_attempts` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

Stripe invoice reconciliation events

- BillingStripeInvoiceEventsResponseDoc
  - `code` integer
  - `data` BillingStripeInvoiceEventDoc[]
    - `amount_due` integer
    - `amount_paid` integer
    - `amount_remaining` integer
    - `charge_id` string
    - `currency` string
    - `discount_cents` integer
    - `due_date` string
    - `error` string
    - `event_created` string
    - `event_id` string
    - `event_type` string
    - `hosted_invoice_url` string
    - `invoice_payment_ids` string[]
    - `invoice_pdf` string
    - `line_items` BillingStripeInvoiceLineItemDoc[]
      - `amount_cents` integer
      - `category` string
      - `currency` string
      - `description` string
      - `line_id` string
      - `period_end` string
      - `period_start` string
      - `proration` boolean
      - `source_ref` string
      - `type` string
    - `match_status` string
    - `matched_period_key` string
    - `matched_user_id` string
    - `payment_intent_id` string
    - `period_end` string
    - `period_start` string
    - `post_payment_credit_note_cents` integer
    - `pre_payment_credit_note_cents` integer
    - `processed_at` string
    - `reconciliation_status` string
    - `repair_attempts` integer
    - `repair_last_attempt_at` string
    - `repair_last_error` string
    - `repair_source` string
    - `repair_status` string
    - `stripe_customer_id` string
    - `stripe_invoice_id` string
    - `stripe_invoice_number` string
    - `stripe_invoice_status` string
    - `subtotal_cents` integer
    - `subtotal_excluding_tax_cents` integer
    - `tax_cents` integer
    - `total_cents` integer
    - `total_excluding_tax_cents` integer
  - `msg` string

## Other responses

- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)