repull 0.2.31 → 0.2.32

data/lib/repull/models/transaction_payout.rb

@@ -0,0 +1,198 @@
+=begin
+#Repull API
+
+#The unified API for vacation rental tech. Connect to 50+ PMS platforms and 4 OTA channels through one REST API. Built-in AI operations for guest communication, pricing, and listing optimization.  ## Designed for AI agents Every error response on this API includes machine-parseable fields so an LLM (Claude in MCP, Cursor, Cline, GPT, etc.) can self-recover without escalating to a human: - `error.code` — stable string identifier (e.g. `invalid_params`, `rate_limit_exceeded`) - `error.message` — human-readable cause - `error.fix` — exact recovery steps (e.g. \"Pass `check_in_after` as ISO 8601: `?check_in_after=2026-01-15`\") - `error.docs_url` — link to the canonical write-up at `https://repull.dev/docs/errors/{code}` - `error.request_id` — id to correlate with server-side logs - `error.field` / `error.value_received` / `error.valid_values` / `error.did_you_mean` — when the error is parameter-specific - `error.retry_after` — seconds to wait before retrying (rate-limit + transient upstream)  `Access-Control-Expose-Headers` lists `x-request-id` and the `X-RateLimit-*` family so browsers can read them on cross-origin responses.  ## Quick Start 1. Get an API key at https://repull.dev/dashboard 2. Connect a PMS: `POST /v1/connect/{provider}` 3. List properties: `GET /v1/properties` 4. Get reservations: `GET /v1/reservations`  ## Authentication All requests require a Bearer token: ``` Authorization: Bearer sk_live_YOUR_API_KEY ```  ## Request Correlation (X-Request-ID) Every response carries an `X-Request-ID` header, e.g. `X-Request-ID: req_01HXY...`. Include this id in support tickets and bug reports — we can trace the full request lifecycle (auth, rate limit, handler, downstream calls, log row) from a single id.  You may set the header on the inbound request to forward your own trace id; we will echo it back instead of generating a new one. Accepted format: `^[\\\\w.-]{1,128}$`.  The id is also embedded in error envelopes as `request_id` so server-side log diffs work even when the response headers are stripped by an intermediate proxy.  ## Rate Limits The public API enforces a per-API-key sliding-window rate limit on top of the per-tier monthly + daily-AI quotas.  **Default policy:** 600 requests per 60 seconds, per API key. Sliding window — there is no fixed-minute boundary you can burst across.  Every response includes:  | Header | Meaning | |---|---| | `X-RateLimit-Limit` | Requests permitted in the current window. | | `X-RateLimit-Remaining` | Requests left in the current window after this call. | | `X-RateLimit-Reset` | Unix epoch (seconds) when the next slot opens. | | `X-RateLimit-Policy` | Machine-readable policy descriptor, e.g. `600;w=60`. | | `Retry-After` | Seconds to wait before retrying. **Only present on 429 responses.** |  **On 429 (rate_limit_exceeded):** the response body matches the standard error envelope with `code: \"rate_limit_exceeded\"`, plus `limit`, `window_seconds`, `retry_after`, and `request_id` fields. SDKs MUST honor `Retry-After` and use exponential backoff with jitter on subsequent retries — never a tight loop.  Recommended backoff: ``` sleep_ms = (Retry-After * 1000) + random(0..250) ```  Monthly + daily-AI tier quotas (`free`, `starter`, `custom`) are enforced separately and also surface as 429s; they include `tier`, `scope`, and `resetsAt` fields.  ## Plan Limits (402 — `listings_limit_exceeded`) The Repull API also enforces a per-tier cap on **active listings**:  | Tier | Active listings cap | |---|---| | `free` | 3 | | `starter` | unlimited (10 included, then billed per listing) | | `custom` | unlimited |  When a customer's active-listing count is above their tier cap, the API returns **`402 Payment Required`** with `error.code = \"listings_limit_exceeded\"` on every route EXCEPT:  - `/v1/health` — uptime probes are never gated. - `/v1/usage/*` — so dashboards can render the over-cap state. - Any `DELETE` — so the customer can trim listings to get back under the cap without paying.  Unlike 429, 402 is NOT a \"wait and retry\" condition — `Retry-After` is not set. The only paths back to 200 are:   1. `DELETE` enough listings to come back under the cap, or   2. Upgrade at `https://repull.dev/dashboard/billing`. The server-side usage cache is 60s, so the first 200 after an upgrade may take up to a minute.  The envelope mirrors `rate_limit_exceeded` for SDK ergonomics: `tier`, `limit`, `active_listings`, `upgrade_url`, plus the standard `code` / `message` / `fix` / `docs_url` / `request_id`.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Repull
+  class TransactionPayout < ApiModelBase
+    # Reference of the payout this row belongs to.
+    attr_accessor :payout_id
+
+    attr_accessor :payout_date
+
+    # On a payout row: the net paid out to the host.
+    attr_accessor :paid_out_amount
+
+    # Masked destination bank account the payout was sent to (Booking.com payouts, from the statement PDF). Null on channels/rows without one.
+    attr_accessor :bank_destination
+
+    # Link to the channel's original payout statement PDF — the authoritative settlement record (Booking.com). Null when none.
+    attr_accessor :statement_url
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'payout_id' => :'payoutId',
+        :'payout_date' => :'payoutDate',
+        :'paid_out_amount' => :'paidOutAmount',
+        :'bank_destination' => :'bankDestination',
+        :'statement_url' => :'statementUrl'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'payout_id' => :'String',
+        :'payout_date' => :'String',
+        :'paid_out_amount' => :'Float',
+        :'bank_destination' => :'String',
+        :'statement_url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'payout_id',
+        :'payout_date',
+        :'paid_out_amount',
+        :'bank_destination',
+        :'statement_url'
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::TransactionPayout` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::TransactionPayout`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'payout_id')
+        self.payout_id = attributes[:'payout_id']
+      else
+        self.payout_id = nil
+      end
+
+      if attributes.key?(:'payout_date')
+        self.payout_date = attributes[:'payout_date']
+      else
+        self.payout_date = nil
+      end
+
+      if attributes.key?(:'paid_out_amount')
+        self.paid_out_amount = attributes[:'paid_out_amount']
+      else
+        self.paid_out_amount = nil
+      end
+
+      if attributes.key?(:'bank_destination')
+        self.bank_destination = attributes[:'bank_destination']
+      end
+
+      if attributes.key?(:'statement_url')
+        self.statement_url = attributes[:'statement_url']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          payout_id == o.payout_id &&
+          payout_date == o.payout_date &&
+          paid_out_amount == o.paid_out_amount &&
+          bank_destination == o.bank_destination &&
+          statement_url == o.statement_url
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [payout_id, payout_date, paid_out_amount, bank_destination, statement_url].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/repull/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.22.0
 =end
 
 module Repull
-  VERSION = '0.2.31'
+  VERSION = '0.2.32'
 end

data/lib/repull.rb

@@ -299,6 +299,7 @@ require 'repull/models/list_airbnb_thread_messages200_response_data_inner'
 require 'repull/models/list_airbnb_thread_messages200_response_pagination'
 require 'repull/models/list_airbnb_transactions200_response'
 require 'repull/models/list_booking_reservations200_response'
+require 'repull/models/list_booking_transactions200_response'
 require 'repull/models/list_connection_units200_response'
 require 'repull/models/list_connection_units200_response_listing_options_inner'
 require 'repull/models/list_connection_units200_response_units_inner'
@@ -611,6 +612,9 @@ require 'repull/models/sync_airbnb_transactions200_response_accounts_inner'
 require 'repull/models/sync_airbnb_transactions200_response_accounts_inner_error'
 require 'repull/models/sync_airbnb_transactions_request'
 require 'repull/models/test_webhook_request'
+require 'repull/models/transaction'
+require 'repull/models/transaction_fees'
+require 'repull/models/transaction_payout'
 require 'repull/models/update_airbnb_booking_settings200_response'
 require 'repull/models/update_airbnb_booking_settings200_response_data'
 require 'repull/models/update_airbnb_booking_settings_request'
@@ -702,6 +706,7 @@ require 'repull/api/reservations_api'
 require 'repull/api/reviews_api'
 require 'repull/api/schema_api'
 require 'repull/api/system_api'
+require 'repull/api/transactions_api'
 require 'repull/api/vrbo_api'
 require 'repull/api/webhooks_api'
 require 'repull/api/workspaces_api'

data/openapi/v1.json

@@ -58,6 +58,10 @@
       "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": "Availability",
       "description": "Check and update property availability and pricing"
@@ -593,6 +597,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",
@@ -2731,6 +2759,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"
           }
         }
       },
@@ -7235,6 +7287,151 @@
           }
         }
       },
+      "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": "Link to the channel's original payout statement PDF \u2014 the authoritative settlement record (Booking.com). Null when none."
+              }
+            }
+          },
+          "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
+          }
+        }
+      },
       "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 +37494,184 @@
           }
         }
       }
+    },
+    "/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"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
     }
   }
 }