Integration Events

List integration events

Browse everything the payment gateways have sent to Factuarea. This is the inbox to open when a charge did not generate its invoice: every discarded event carries a typed discard_reason and whether it can be reprocessed. Newest first, and scoped to the authenticated company. The raw content of the event is never returned.

get/companies/{company}/integrations/events

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/integrations/events
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Query parameters

provider'stripe' | 'gocardless' | 'monei' | 'slack' | 'teams' | 'a3' | 'norma43' | 'norma19' | 'ubl' | 'woocommerce' | 'shopify' | 'prestashop'

Payment gateway or integration that produced the event.

status'success' | 'skipped' | 'failure'

Outcome of the event (success, skipped, failure).

event_typestring

Provider event type, matched exactly. Free-form text, not a closed enum.

discard_reason'event_not_normalizable' | 'duplicate_redelivery' | 'connected_account_missing' | 'connected_account_unknown' | 'spontaneous_payment_missing_id' | 'autoinvoicing_disabled' | 'unsupported_currency' | 'refund_without_items' | 'refund_autoinvoicing_disabled' | 'subscription_missing_invoice_id' | 'subscription_proration_review' | 'subscription_not_a_cycle' | 'subscription_trial_skipped' | 'subscription_autoinvoicing_disabled' | 'subscription_already_invoiced' | 'payout_missing_id' | 'payout_connected_account_missing' | 'payment_failed' | 'event_type_not_covered' | 'checkout_lines_retrieve_failed' | 'reversal_payment_not_found' | 'reversal_already_applied' | 'dispute_in_progress' | 'dispute_resolved' | 'test_mode_event' | 'order_event_not_covered' | 'store_not_found' | 'store_environment_test' | 'refund_before_order' | 'refund_reason_unmapped' | 'recurring_invoice_overlap' | 'series_date_clamped' | 'store_autoinvoicing_disabled' | 'vat_residual_out_of_tolerance' | 'simplified_absolute_limit_exceeded' | 'simplified_threshold_exceeded_without_recipient' | 'store_requires_tax_id' | 'order_line_amount_exceeds_column' | 'order_status_unknown' | 'refund_not_settled' | 'protected_customer_data_unavailable' | 'excluded_by_charge_rule' | 'handled_by_stripe_invoice' | 'stripe_authorization_required' | 'stripe_app_uninstalled' | 'refund_of_non_invoiced_charge' | 'stripe_invoice_without_amount' | 'deauthorization_not_applicable'

Typed reason why the event was discarded, from the closed catalogue.

is_parkedboolean

Whether the event was parked with its content so it can be replayed.

created_at[gte]string date-time

Inclusive lower bound of created_at (ISO 8601).

created_at[lte]string date-time

Inclusive upper bound of created_at (ISO 8601).

limitinteger

Number of events to return, between 1 and 100 (default 25).

starting_afterstring
Example:91544

Cursor for forward pagination: the next_cursor of the previous page, an opaque numeric string (not a UUID v7). A malformed cursor returns 400.

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

IntegrationEventListV1Resource

has_moreboolean required

true when more events exist beyond this page.

next_cursorstring nullable required

Opaque cursor to pass as starting_after for the next page, or null when has_more is false. Unlike the rest of the v1 listings it is a numeric string, not a UUID v7 — treat it as opaque and reuse it verbatim.

Example response

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a9b",
      "object": "integration_event",
      "provider": "stripe",
      "event_type": "invoice.paid",
      "direction": "inbound",
      "status": "skipped",
      "discard_reason": "autoinvoicing_disabled",
      "discard_reason_label": "Auto-facturación desactivada",
      "is_actionable": true,
      "is_replayable": true,
      "duration_ms": 184,
      "created_at": "2026-07-15T09:30:12+00:00",
      "recommended_action": "Elige una de las dos salidas, no las dos: activa la auto-facturación en la configuración de la integración y reprocesa el evento, o crea la factura a mano. Si haces ambas, el cobro acabará con dos facturas."
    }
  ],
  "has_more": true,
  "next_cursor": "91544"
}

Changes

No recorded changes to this operation across all 1 revision of this API.