@spec get(Pluggy.Client.t(), String.t()) :: {:ok, term()} | {:error, Pluggy.Error.t()}

Gets a transaction by ID.

@spec list(Pluggy.Client.t(), String.t() | map(), keyword()) ::
  {:ok, term()} | {:error, Pluggy.Error.t()}

Lists transactions for a given account.

The second argument accepts either an account ID string or an account map (e.g. an entry from Pluggy.Accounts.list/2) — the :id field is extracted automatically, making it easy to pipe the two calls together:

{:ok, %{results: [account | _]}} = Pluggy.Accounts.list(client, item_id)
Pluggy.Transactions.list(client, account)

Options

• :from - Start date filter
• :to - End date filter
• :page_size - Number of results per page (1-500)
• :page - Page number

@spec list_with_cursor(Pluggy.Client.t(), String.t() | map(), keyword()) ::
  {:ok, map(), Pluggy.HTTP.Cursor.t() | nil} | {:error, Pluggy.Error.t()}

Lists transactions with cursor-based pagination.

The second argument accepts either an account ID string or an account map — the :id field is extracted automatically.

Returns {:ok, response, cursor} where cursor is a %Pluggy.HTTP.Cursor{} when more pages are available, or nil when on the last page.

Pass the cursor to Pluggy.HTTP.with_cursor/1 to fetch the next page.

@spec update(Pluggy.Client.t(), String.t(), map()) ::
  {:ok, term()} | {:error, Pluggy.Error.t()}

Updates a transaction (e.g. to change its category).