Billing

List Stripe invoice reconciliation events

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

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

Query parameters

status'matched' | 'unmatched'

Match status

customer_idstring

Stripe customer id

invoice_idstring

Stripe invoice id

repair_status'pending' | 'running' | 'succeeded' | 'failed' | 'skipped'

Stripe repair status

repair_source'webhook_auto' | 'admin_manual'

Repair source

min_repair_attemptsinteger

Minimum repair attempts

limitinteger

Maximum events to return. Defaults to 50 and clamps to 5000.

Headers

x-api-keystring required

Admin API key required unless an Admin JWT is already present

Response

Stripe invoice reconciliation events

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": [
    {
      "amount_due": 19900,
      "amount_paid": 19900,
      "charge_id": "ch_123",
      "currency": "usd",
      "due_date": "2026-05-08T00:00:00Z",
      "event_created": "2026-05-01T01:01:00Z",
      "event_id": "evt_123",
      "event_type": "invoice.paid",
      "hosted_invoice_url": "https://invoice.stripe.com/i/acct_...",
      "invoice_pdf": "https://pay.stripe.com/invoice/.../pdf",
      "line_items": [
        {
          "amount_cents": 7900,
          "category": "subscription",
          "currency": "usd",
          "description": "Pro plan",
          "line_id": "il_123",
          "period_end": "2026-05-01T00:00:00Z",
          "period_start": "2026-04-01T00:00:00Z",
          "source_ref": "sub_123",
          "type": "subscription"
        }
      ],
      "match_status": "matched",
      "matched_period_key": "2026-04",
      "matched_user_id": "user-1",
      "payment_intent_id": "pi_123",
      "period_end": "2026-05-01T00:00:00Z",
      "period_start": "2026-04-01T00:00:00Z",
      "processed_at": "2026-05-01T01:01:02Z",
      "reconciliation_status": "paid",
      "repair_attempts": 1,
      "repair_last_attempt_at": "2026-05-01T02:00:00Z",
      "repair_source": "admin_manual",
      "repair_status": "pending",
      "stripe_customer_id": "cus_123",
      "stripe_invoice_id": "in_123",
      "stripe_invoice_number": "C8F8C2D-0001",
      "stripe_invoice_status": "paid",
      "subtotal_cents": 19900,
      "subtotal_excluding_tax_cents": 19900,
      "total_cents": 19900,
      "total_excluding_tax_cents": 19900
    }
  ],
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.