RubyGems - repull - Versions diffs - 0.2.31 → 0.2.33 - Mend

repull 0.2.31 → 0.2.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

checksums.yaml +4 -4
data/README.md +1 -1
data/lib/repull/api/booking_com_api.rb +80 -0
data/lib/repull/api/connections_api.rb +77 -0
data/lib/repull/api/resolutions_api.rb +236 -0
data/lib/repull/api/transactions_api.rb +182 -0
data/lib/repull/models/account_import.rb +237 -0
data/lib/repull/models/account_import_completed_event.rb +282 -0
data/lib/repull/models/account_import_counts.rb +193 -0
data/lib/repull/models/account_import_failed_event.rb +282 -0
data/lib/repull/models/account_import_finished_payload.rb +224 -0
data/lib/repull/models/account_import_stage.rb +177 -0
data/lib/repull/models/account_import_started_event.rb +282 -0
data/lib/repull/models/account_import_started_payload.rb +177 -0
data/lib/repull/models/connection.rb +16 -5
data/lib/repull/models/list_airbnb_resolutions200_response.rb +192 -0
data/lib/repull/models/list_booking_transactions200_response.rb +158 -0
data/lib/repull/models/list_connection_imports200_response.rb +158 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response.rb +219 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response_accounts_inner.rb +200 -0
data/lib/repull/models/refresh_airbnb_resolutions200_response_accounts_inner_error.rb +156 -0
data/lib/repull/models/refresh_airbnb_resolutions_request.rb +192 -0
data/lib/repull/models/reservation.rb +45 -1
data/lib/repull/models/reservation_webhook_object.rb +49 -5
data/lib/repull/models/resolution.rb +329 -0
data/lib/repull/models/transaction.rb +349 -0
data/lib/repull/models/transaction_fees.rb +176 -0
data/lib/repull/models/transaction_payout.rb +209 -0
data/lib/repull/models/webhook_event.rb +6 -0
data/lib/repull/models/webhook_event_type.rb +4 -1
data/lib/repull/version.rb +1 -1
data/lib/repull.rb +21 -0
data/openapi/v1.json +1295 -153
data/scripts/regen.sh +1 -1
metadata +23 -2

data/openapi/v1.json CHANGED Viewed

@@ -58,6 +58,14 @@
       "name": "Reservations",
       "description": "Query, create, update, and cancel reservations"
     },
+    {
+      "name": "Transactions",
+      "description": "Unified transactions & payments ledger across channels \u2014 payouts, reservation charges, refunds. `booking` covers Booking.com however it was connected."
+    },
+    {
+      "name": "Resolutions",
+      "description": "Airbnb Resolution Center cases (AirCover / damage, extra-guest, refund and change requests) \u2014 read-only visibility on open and closed resolutions. The money a resolution moved is in the transactions ledger; join on the resolution id."
+    },
     {
       "name": "Availability",
       "description": "Check and update property availability and pricing"
@@ -593,6 +601,30 @@
             "description": "Local check-out time for this stay, `HH:MM` on a 24-hour clock in the property's own timezone. Pair with `checkOut` to schedule the turnover clean. `null` when unknown. This is the same field `PATCH /v1/reservations/{id}` writes.",
             "example": "10:00"
           },
+          "guestNotes": {
+            "type": "string",
+            "nullable": true,
+            "description": "What the guest wrote with the booking, as the channel sent it. Booking.com puts the estimated arrival time and special requests here. Free text, never parsed. `null` when the guest left none.",
+            "example": "Approximate time of arrival: between 15:00 and 16:00"
+          },
+          "conversationId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The conversation with this guest \u2014 pass it to `GET /v1/conversations/{id}` and `/v1/conversations/{id}/messages`. It is the same conversation from inquiry through pre-approval to the confirmed booking, and the same id the message webhooks carry, so a booking links straight to the messages that led to it. `null` when the channel has no conversation for this booking.",
+            "example": "164743"
+          },
+          "externalThreadId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The channel's own id for that conversation (Airbnb thread id, Booking.com conversation id, \u2026). `null` when there is none.",
+            "example": "2680544213"
+          },
+          "inquiryId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The inquiry this booking came from (`GET /v1/inquiries`), when the guest asked before booking. When an inquiry turns into a booking, `inquiry.updated` fires with `status: \"booked\"` and this reservation's id. `null` for bookings with no inquiry.",
+            "example": "25173"
+          },
           "status": {
             "type": "string",
             "example": "confirmed",
@@ -1516,6 +1548,15 @@
             "format": "uri",
             "nullable": true,
             "description": "Durable link that reopens the hosted Connect flow bound to this account on the fix screen \u2014 send the host here to resolve `action`. Present only when `action.required` is true; `null` otherwise."
+          },
+          "import": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/AccountImport"
+              }
+            ],
+            "nullable": true,
+            "description": "The account's latest import \u2014 `status: running` while the first sync (or a later one) is going, then `completed` or `failed`. `null` when no import has been recorded. The same run is announced by the `account.import.*` webhooks; the history is on `GET /v1/connections/{id}/imports`."
           }
         }
       },
@@ -2645,6 +2686,9 @@
           "account.created",
           "connect.session.completed",
           "account.disconnected",
+          "account.import.started",
+          "account.import.completed",
+          "account.import.failed",
           "review.created",
           "review.responded",
           "ai.operation.completed",
@@ -2731,6 +2775,30 @@
             "nullable": true,
             "description": "Local check-out time, `HH:MM` on a 24-hour clock in the property's own timezone. Pair it with `checkoutDate` to schedule the turnover. `null` when unknown.",
             "example": "10:00"
+          },
+          "guestNotes": {
+            "type": "string",
+            "nullable": true,
+            "description": "What the guest wrote with the booking \u2014 on Booking.com, the estimated arrival time and special requests. Free text. `null` when there were none.",
+            "example": "Approximate time of arrival: between 15:00 and 16:00"
+          },
+          "conversationId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The conversation with this guest \u2014 pass it to `GET /v1/conversations/{id}` and `/v1/conversations/{id}/messages`. It is the same conversation from inquiry through pre-approval to the confirmed booking, and the same id the message webhooks carry, so a booking links straight to the messages that led to it. `null` when the channel has no conversation for this booking.",
+            "example": "164743"
+          },
+          "externalThreadId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The channel's own id for that conversation (Airbnb thread id, Booking.com conversation id, \u2026). `null` when there is none.",
+            "example": "2680544213"
+          },
+          "inquiryId": {
+            "type": "string",
+            "nullable": true,
+            "description": "The inquiry this booking came from (`GET /v1/inquiries`), when the guest asked before booking. When an inquiry turns into a booking, `inquiry.updated` fires with `status: \"booked\"` and this reservation's id. `null` for bookings with no inquiry.",
+            "example": "25173"
           }
         }
       },
@@ -4838,223 +4906,492 @@
           }
         }
       },
-      "ConnectSessionCompletedEvent": {
+      "AccountImportStage": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "One stage of an account import (e.g. `reservations`). The stage is done when `done + failed` reaches `expected`.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
-          },
-          "apiVersion": {
+          "name": {
             "type": "string",
-            "example": "2026-04"
+            "example": "reservations"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "expected": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Units of work in this stage (one per page, chunk, listing or thread, depending on the channel). `null` until the stage knows its size."
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "done": {
+            "type": "integer"
           },
-          "data": {
-            "$ref": "#/components/schemas/ConnectSessionCompletedPayload"
+          "failed": {
+            "type": "integer"
           }
         }
       },
-      "AccountDisconnectedEvent": {
+      "AccountImportCounts": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "What the import brought in. A channel reports the keys it imports.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+          "listings": {
+            "type": "integer"
           },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          "reservations": {
+            "type": "integer"
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "conversations": {
+            "type": "integer"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "messages": {
+            "type": "integer"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "reviews": {
+            "type": "integer"
           },
-          "data": {
-            "$ref": "#/components/schemas/AccountDisconnectedPayload"
+          "payments": {
+            "type": "integer"
           }
         }
       },
-      "ReviewCreatedEvent": {
+      "AccountImport": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
+        "description": "One import run of a connected account: the first sync after connecting, a room or unit mapped later, a reconnect or a re-sync.",
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
+          "id": {
             "type": "string",
             "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "description": "The import id \u2014 the `importId` on `account.import.*` webhooks."
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "status": {
+            "type": "string"
           },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+          "trigger": {
+            "type": "string"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "outcome": {
+            "type": "string",
+            "nullable": true,
+            "description": "`completed` imports only: `partial` when some units failed (see `stages`)."
           },
-          "data": {
-            "$ref": "#/components/schemas/ReviewCreatedPayload"
-          }
-        }
-      },
-      "ReviewRespondedEvent": {
-        "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
-        "properties": {
-          "event": {
+          "reason": {
             "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+            "nullable": true,
+            "description": "`failed` imports only: why it stopped \u2014 e.g. `needs_permissions`, `duplicate_account`, `stalled`."
           },
-          "eventId": {
+          "startedAt": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "date-time"
           },
-          "apiVersion": {
+          "lastActivityAt": {
             "type": "string",
-            "example": "2026-04"
+            "format": "date-time"
           },
-          "timestamp": {
+          "completedAt": {
             "type": "string",
             "format": "date-time",
-            "description": "When this delivery was built."
+            "nullable": true
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "stages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountImportStage"
+            }
           },
-          "data": {
-            "$ref": "#/components/schemas/ReviewRespondedPayload"
+          "counts": {
+            "$ref": "#/components/schemas/AccountImportCounts"
           }
         }
       },
-      "AiOperationCompletedEvent": {
+      "AccountImportStartedPayload": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
         "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
+          "importId": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "format": "uuid"
           },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
+          "trigger": {
+            "type": "string"
           },
-          "timestamp": {
+          "startedAt": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
-          },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+            "format": "date-time"
           },
-          "data": {
-            "$ref": "#/components/schemas/AiOperationCompletedPayload"
+          "stages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The stages this import will run."
           }
         }
       },
-      "AiOperationFailedEvent": {
+      "AccountImportFinishedPayload": {
         "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
         "properties": {
-          "event": {
+          "importId": {
             "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
+            "format": "uuid"
           },
-          "eventId": {
+          "trigger": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "outcome": {
             "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+            "nullable": true
           },
-          "apiVersion": {
+          "startedAt": {
             "type": "string",
-            "example": "2026-04"
+            "format": "date-time"
           },
-          "timestamp": {
+          "completedAt": {
             "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
+            "format": "date-time"
           },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
+          "stages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AccountImportStage"
+            }
           },
-          "data": {
-            "$ref": "#/components/schemas/AiOperationFailedPayload"
+          "counts": {
+            "$ref": "#/components/schemas/AccountImportCounts"
+          },
+          "reason": {
+            "type": "string",
+            "nullable": true,
+            "description": "`account.import.failed` only."
           }
         }
       },
-      "PaymentCompletedEvent": {
+      "AccountImportStartedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportStartedPayload"
+          }
+        },
+        "description": "An account import began."
+      },
+      "AccountImportCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportFinishedPayload"
+          }
+        },
+        "description": "Every stage of an account import finished. Its data is readable through the API."
+      },
+      "AccountImportFailedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountImportFinishedPayload"
+          }
+        },
+        "description": "An account import stopped before finishing; `data.reason` says why."
+      },
+      "ConnectSessionCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ConnectSessionCompletedPayload"
+          }
+        }
+      },
+      "AccountDisconnectedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AccountDisconnectedPayload"
+          }
+        }
+      },
+      "ReviewCreatedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ReviewCreatedPayload"
+          }
+        }
+      },
+      "ReviewRespondedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/ReviewRespondedPayload"
+          }
+        }
+      },
+      "AiOperationCompletedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AiOperationCompletedPayload"
+          }
+        }
+      },
+      "AiOperationFailedEvent": {
+        "type": "object",
+        "required": [
+          "event",
+          "eventId",
+          "apiVersion",
+          "timestamp",
+          "data"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "description": "The event name. This field is `event`, not `type`."
+          },
+          "eventId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
+          },
+          "apiVersion": {
+            "type": "string",
+            "example": "2026-04"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this delivery was built."
+          },
+          "account": {
+            "$ref": "#/components/schemas/WebhookEventAccount"
+          },
+          "data": {
+            "$ref": "#/components/schemas/AiOperationFailedPayload"
+          }
+        }
+      },
+      "PaymentCompletedEvent": {
         "type": "object",
         "required": [
           "event",
@@ -5437,6 +5774,15 @@
           {
             "$ref": "#/components/schemas/AccountDisconnectedEvent"
           },
+          {
+            "$ref": "#/components/schemas/AccountImportStartedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/AccountImportCompletedEvent"
+          },
+          {
+            "$ref": "#/components/schemas/AccountImportFailedEvent"
+          },
           {
             "$ref": "#/components/schemas/ReviewCreatedEvent"
           },
@@ -5495,6 +5841,9 @@
             "account.created": "#/components/schemas/AccountCreatedEvent",
             "connect.session.completed": "#/components/schemas/ConnectSessionCompletedEvent",
             "account.disconnected": "#/components/schemas/AccountDisconnectedEvent",
+            "account.import.started": "#/components/schemas/AccountImportStartedEvent",
+            "account.import.completed": "#/components/schemas/AccountImportCompletedEvent",
+            "account.import.failed": "#/components/schemas/AccountImportFailedEvent",
             "review.created": "#/components/schemas/ReviewCreatedEvent",
             "review.responded": "#/components/schemas/ReviewRespondedEvent",
             "ai.operation.completed": "#/components/schemas/AiOperationCompletedEvent",
@@ -7235,6 +7584,248 @@
           }
         }
       },
+      "Transaction": {
+        "type": "object",
+        "description": "One row of the unified transactions & payments ledger: a payout (`isPayout: true`) or a reservation charge / refund, on any channel. `platform` is normalized \u2014 `booking` is Booking.com however the account was connected (never `booking_extranet`). For a payout, `amount` is the net the host received, `grossAmount` the guest-paid gross, and `fees` the deductions (commission, payments service fee, processing fee).",
+        "required": [
+          "transactionId",
+          "platform",
+          "isPayout",
+          "fees",
+          "payout"
+        ],
+        "properties": {
+          "transactionId": {
+            "type": "string",
+            "nullable": true,
+            "description": "Stable id of the transaction (the underlying payment id). Upsert on it.",
+            "example": "booking_payout_5463377687_bank_transfer"
+          },
+          "platform": {
+            "type": "string",
+            "nullable": true,
+            "description": "Normalized channel: `airbnb`, `booking` (Booking.com, however connected \u2014 never `booking_extranet`), or `vrbo`.",
+            "example": "booking"
+          },
+          "type": {
+            "type": "string",
+            "nullable": true,
+            "description": "Transaction type: `Payout`, `Reservation`, `Refund`, \u2026",
+            "example": "Payout"
+          },
+          "isPayout": {
+            "type": "boolean",
+            "description": "`true` when this is money that reached the host (a payout)."
+          },
+          "status": {
+            "type": "string",
+            "nullable": true,
+            "description": "Normalized settlement status (`COMPLETED` / `UPCOMING`; the raw value passes through when it maps to neither).",
+            "example": "COMPLETED"
+          },
+          "date": {
+            "type": "string",
+            "nullable": true,
+            "description": "Transaction / payout date (the channel's display form or ISO).",
+            "example": "27 Aug 2026"
+          },
+          "currency": {
+            "type": "string",
+            "nullable": true,
+            "example": "NOK"
+          },
+          "amount": {
+            "type": "number",
+            "nullable": true,
+            "description": "Net amount; for a payout, what the host received.",
+            "example": 18597.12
+          },
+          "grossAmount": {
+            "type": "number",
+            "nullable": true,
+            "description": "Guest-paid gross (payouts).",
+            "example": 22272
+          },
+          "fees": {
+            "type": "object",
+            "required": [
+              "commission",
+              "serviceFee",
+              "processingFee"
+            ],
+            "properties": {
+              "commission": {
+                "type": "number",
+                "nullable": true,
+                "description": "Channel commission deducted.",
+                "example": 3340.8
+              },
+              "serviceFee": {
+                "type": "number",
+                "nullable": true,
+                "description": "Payments service fee deducted.",
+                "example": 334.08
+              },
+              "processingFee": {
+                "type": "number",
+                "nullable": true
+              }
+            }
+          },
+          "payout": {
+            "type": "object",
+            "required": [
+              "payoutId",
+              "payoutDate",
+              "paidOutAmount"
+            ],
+            "properties": {
+              "payoutId": {
+                "type": "string",
+                "nullable": true,
+                "description": "Reference of the payout this row belongs to.",
+                "example": "gkvDj0Jm9ZaA6IiO"
+              },
+              "payoutDate": {
+                "type": "string",
+                "nullable": true
+              },
+              "paidOutAmount": {
+                "type": "number",
+                "nullable": true,
+                "description": "On a payout row: the net paid out to the host.",
+                "example": 18597.12
+              },
+              "bankDestination": {
+                "type": "string",
+                "nullable": true,
+                "description": "Masked destination bank account the payout was sent to (Booking.com payouts, from the statement PDF). Null on channels/rows without one.",
+                "example": "NO***********404"
+              },
+              "statementUrl": {
+                "type": "string",
+                "nullable": true,
+                "description": "Repull-hosted download link for the original payout statement PDF (the authoritative settlement record). Add `?format=csv` for the CSV. Served by `GET /v1/transactions/{id}/statement` \u2014 no channel session needed. Null when none is stored."
+              },
+              "statementId": {
+                "type": "string",
+                "nullable": true,
+                "description": "The channel's own numeric statement id (Booking.com, e.g. \"010747030095\"). Null when none.",
+                "example": "010747030095"
+              }
+            }
+          },
+          "confirmationCode": {
+            "type": "string",
+            "nullable": true,
+            "example": "5463377687"
+          },
+          "reservationId": {
+            "type": "integer",
+            "nullable": true
+          },
+          "listingId": {
+            "type": "integer",
+            "nullable": true
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
+      "Resolution": {
+        "type": "object",
+        "description": "An Airbnb Resolution Center case (AirCover / damage, extra-guest, refund or change request). Read-only \u2014 Airbnb exposes no create/evidence/status API. The money a resolution moved rides in the transactions ledger as `Resolution Payout` / `Resolution Adjustment` rows sharing the same reference; join on `resolutionId`.",
+        "required": [
+          "resolutionId",
+          "status"
+        ],
+        "properties": {
+          "resolutionId": {
+            "type": "string",
+            "description": "Airbnb's resolution id \u2014 the `{id}` path value and the join key to a transaction's `reference`.",
+            "example": "CLSF-06464054"
+          },
+          "confirmationCode": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb confirmation code of the reservation the case is on.",
+            "example": "HMZKMYCBC5"
+          },
+          "reservationId": {
+            "type": "integer",
+            "nullable": true,
+            "description": "Repull's internal reservation id, when the reservation is in this workspace."
+          },
+          "listingName": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "nullable": true,
+            "description": "OPEN or CLOSED, as Airbnb reports it.",
+            "example": "OPEN"
+          },
+          "reason": {
+            "type": "string",
+            "nullable": true,
+            "description": "Why the resolution was opened."
+          },
+          "caseStatus": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb's case-status label."
+          },
+          "statusText": {
+            "type": "string",
+            "nullable": true,
+            "description": "Human-readable status detail."
+          },
+          "suggestedActionText": {
+            "type": "string",
+            "nullable": true,
+            "description": "Airbnb's hint on whose turn it is to act next \u2014 track progress with it."
+          },
+          "customerSupportInitiated": {
+            "type": "boolean",
+            "nullable": true,
+            "description": "True when Airbnb Customer Support (not the host/guest) opened the case."
+          },
+          "productType": {
+            "type": "string",
+            "nullable": true
+          },
+          "initiator": {
+            "type": "object",
+            "nullable": true,
+            "description": "Who opened the case (id + name)."
+          },
+          "responder": {
+            "type": "object",
+            "nullable": true,
+            "description": "Who responds (id + name)."
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When Repull last refreshed this case from Airbnb."
+          }
+        }
+      },
       "AirbnbConnectionHost": {
         "type": "object",
         "description": "One Airbnb host record under the workspace, decorated with its most recent disconnect reason from `airbnb_host_events` (backfill events excluded).",
@@ -37297,6 +37888,557 @@
           }
         }
       }
+    },
+    "/v1/channels/booking/transactions": {
+      "get": {
+        "operationId": "list_booking_transactions",
+        "summary": "List Booking.com transactions (settlement ledger)",
+        "description": "The Booking.com settlement ledger for this workspace: every payout (Payments by Booking.com \u2192 bank transfer) and reservation charge, with the gross the guest paid, Booking's commission and payments service fee, and the net paid out, each tied to its reservation. Official Connectivity-API and extranet-connected accounts are returned together as one Booking.com \u2014 there is no `booking_extranet` distinction and nothing extra to request. Cursor-paginated, newest first. (For all channels at once, use `/v1/transactions`.)",
+        "tags": [
+          "Booking.com"
+        ],
+        "parameters": [
+          {
+            "name": "type",
+            "in": "query",
+            "required": false,
+            "description": "Filter by transaction type, e.g. `Payout`, `Reservation`, `Refund`.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "description": "Filter by raw status.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "is_payout",
+            "in": "query",
+            "required": false,
+            "description": "When `true`, only payout rows (money that reached the host).",
+            "schema": {
+              "type": "boolean"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "description": "Page size (default 100, max 500).",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 500
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "description": "Opaque pagination cursor from a previous `pagination.nextCursor`.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A page of Booking.com transactions.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/Transaction"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/CursorPagination"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/transactions": {
+      "get": {
+        "operationId": "list_transactions",
+        "summary": "List transactions & payments (unified ledger)",
+        "description": "Every channel's money in one ledger: payouts that reached the host, reservation charges, refunds and adjustments, across Airbnb, Booking.com and Vrbo. Each row carries a normalized `platform` \u2014 `booking` always means Booking.com however the account was connected (official API or extranet); there is no `booking_extranet`, and `?platform=booking` matches all of them. A payout row's `amount` is the net the host received; `grossAmount` is what the guest paid and `fees` the deductions (commission, payments service fee, processing fee). Cursor-paginated, newest first.",
+        "tags": [
+          "Transactions"
+        ],
+        "parameters": [
+          {
+            "name": "platform",
+            "in": "query",
+            "required": false,
+            "description": "Filter to one channel: `airbnb`, `booking` (Booking.com, however connected), or `vrbo`. Omit for all channels.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "airbnb",
+                "booking",
+                "vrbo"
+              ]
+            }
+          },
+          {
+            "name": "type",
+            "in": "query",
+            "required": false,
+            "description": "Filter by transaction type, e.g. `Payout`, `Reservation`, `Refund`.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "description": "Filter by raw status.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "is_payout",
+            "in": "query",
+            "required": false,
+            "description": "When `true`, only payout rows (money that reached the host).",
+            "schema": {
+              "type": "boolean"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "description": "Page size (default 100, max 500).",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 500
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "description": "Opaque pagination cursor from a previous `pagination.nextCursor`.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A page of transactions.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/Transaction"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/CursorPagination"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/transactions/{id}/statement": {
+      "get": {
+        "operationId": "get_transaction_statement",
+        "summary": "Download the original payout statement",
+        "description": "Downloads the channel's ORIGINAL payout statement \u2014 the authoritative settlement record a host reconciles against \u2014 for a payout transaction. `{id}` is the payout `transactionId` (e.g. `booking_payout_5463377687_bank_transfer`). Repull serves the stored bytes itself (no channel session), so unlike the channel's own link it never expires or leaks a session. PDF by default; pass `?format=csv` for the CSV remittance. Returns `404` when no statement was captured for the payout (e.g. an upcoming payout, or a channel that has none).",
+        "tags": [
+          "Transactions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The payout transaction id (`transactionId`).",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "format",
+            "in": "query",
+            "required": false,
+            "description": "Statement format.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pdf",
+                "csv"
+              ],
+              "default": "pdf"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The statement file (PDF by default, or CSV).",
+            "content": {
+              "application/pdf": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              },
+              "text/csv": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/channels/airbnb/resolutions": {
+      "get": {
+        "operationId": "list_airbnb_resolutions",
+        "summary": "List Airbnb Resolution Center cases",
+        "description": "The host's Airbnb Resolution Center cases (AirCover / damage, extra-guest, refund and change requests), open and closed. Served from the database; `POST` this path to refresh from Airbnb. READ-ONLY upstream \u2014 Airbnb's Resolutions API is read-only; a claim is created, evidence added and status changed only in Airbnb's Resolution Center UI, not via API. Use this for visibility and action tracking (`suggestedActionText`). The money a resolution moved is in the transactions ledger as `Resolution Payout` / `Resolution Adjustment` rows sharing the same reference \u2014 join on `resolutionId`. Cursor-paginated, newest first.",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "required": false,
+            "description": "Filter by lifecycle: `open` (still needs action) or `closed` (settled). Omit for all.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "open",
+                "closed"
+              ]
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "description": "Page size (default 50, max 200).",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "required": false,
+            "description": "Opaque pagination cursor from a previous `pagination.nextCursor`.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Resolutions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "data",
+                    "pagination"
+                  ],
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/Resolution"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/Pagination"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      },
+      "post": {
+        "operationId": "refresh_airbnb_resolutions",
+        "summary": "Refresh Airbnb resolutions from Airbnb",
+        "description": "Pulls the latest Resolution Center cases from Airbnb (read-only) and stores them, then read with GET. Optionally scope to one `account_id` and/or `status`.",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "account_id": {
+                    "type": "string",
+                    "description": "Limit the refresh to one Airbnb host id. Omit for all connected accounts."
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "OPEN",
+                      "CLOSED"
+                    ],
+                    "description": "Limit the refresh to one lifecycle. Omit for all."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Refresh outcome.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "synced",
+                    "count",
+                    "accounts"
+                  ],
+                  "properties": {
+                    "synced": {
+                      "type": "boolean"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "description": "Resolutions upserted across all accounts."
+                    },
+                    "accounts": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "account_id",
+                          "count"
+                        ],
+                        "properties": {
+                          "account_id": {
+                            "type": "string"
+                          },
+                          "count": {
+                            "type": "integer"
+                          },
+                          "error": {
+                            "type": "object",
+                            "nullable": true,
+                            "properties": {
+                              "code": {
+                                "type": "string"
+                              },
+                              "message": {
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/channels/airbnb/resolutions/{id}": {
+      "get": {
+        "operationId": "get_airbnb_resolution",
+        "summary": "Get an Airbnb Resolution Center case",
+        "description": "One Airbnb Resolution Center case. `{id}` is the Airbnb resolution id (the `resolutionId` from the list, also a transaction's `reference`). Read-only (see the list endpoint). The amounts moved are in the transactions ledger \u2014 join `resolutionId` to a transaction's `reference`. 404 when it isn't in this workspace (POST the list endpoint to refresh first).",
+        "tags": [
+          "Resolutions"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XSchemaHeader"
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The Airbnb resolution id.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Resolution",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Resolution"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalError"
+          }
+        }
+      }
+    },
+    "/v1/connections/{id}/imports": {
+      "get": {
+        "operationId": "listConnectionImports",
+        "summary": "List a connection's imports",
+        "description": "The import runs of one connected account, newest first: the first sync after connecting, a room or unit mapped later, a reconnect, a re-sync. Each run says where it stands (`running`, `completed`, `failed`), its stages and what it imported.\n\nTo know when an account's first sync is done, wait for the `account.import.completed` webhook, or poll this endpoint (or `GET /v1/connect`, whose connections carry their latest `import`) until the newest run is no longer `running`.\n\nAuth: a Repull API key, or a Connect session token (`sessionId`).",
+        "tags": [
+          "Connections"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Connection handle `{provider}:{externalAccountId}`, e.g. `booking_extranet:36`, `vrbo:12`, `airbnb:1234567`, `hostaway:27434` \u2014 the `provider` and `externalAccountId` of a connection on `GET /v1/connect`, or the account of an `account.*` webhook."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 20
+            },
+            "description": "How many runs to return, newest first."
+          },
+          {
+            "name": "sessionId",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The Connect session ID (capability token)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Imports, newest first. Empty when the account has none recorded.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/AccountImport"
+                      }
+                    },
+                    "pagination": {
+                      "$ref": "#/components/schemas/Pagination"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          }
+        }
+      }
     }
   }
 }