# List Partner Transactions

Returns a list of **pocket** transactions. It does not include transactions between the **bank account** and **brokerage account**.

Endpoint: GET /api/v2/transactions/
Version: Version: 37bc941f
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer

## Query parameters:

  - `cursor` (string)

  - `limit` (integer)

  - `order` (string)

  - `direction` (any)

  - `amount_from` (any)

  - `amount_to` (any)

  - `filter[card]` (any)

  - `filter[portal]` (any)

  - `filter[type]` (any)

  - `filter[on_us_transfer]` (any)

  - `filter[wire]` (any)

  - `time_booked_from` (any)

  - `time_booked_to` (any)

  - `time_settled_from` (any)

  - `time_settled_to` (any)

  - `include_sweeps` (any)

## Header parameters:

  - `x-jiko-idempotency` (string, required)
    A new UUID that you generate for each request, reads included. It is part of the request signature and prevents replay of a request. A value that was already sent in the last hour is rejected with `409 jiko.errors.DuplicateRequestError`, even if the first request failed. When you retry a request, generate a new value and sign the request again.

  - `x-jiko-signature` (string, required)
    Base64-encoded HMAC-SHA256 hash of `x-jiko-idempotency + request pathname + body`, keyed with your shared secret. See [Authentication](/products/partner-api/guides/building/auth) for the full algorithm and a code sample.

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `prev_page` (any)

  - `next_page` (any)

  - `items` (array, required)

  - `items.id` (string, required)
    The ID of the transaction from the perspective of the respective pocket

  - `items.transaction_id` (string, required)
    The ID of the transaction this activity is representing

  - `items.description` (string, required)
    A description of the transaction type, e.g. "ACH Electronic Debit".

  - `items.amount` (object, required)

  - `items.amount.value` (integer, required)
    USD values are always in cents.

  - `items.amount.currency` (string, required)

  - `items.amount.formatted` (string)

  - `items.time_booked` (string, required)
    The time at which the transaction was originally booked into the ledger.

  - `items.time_settled` (any, required)
    The time at which transaction was settled.

  - `items.status` (string, required)
    Status of the transactions. Has the transactions been settled
    Enum: "BOOKED", "SETTLED"

  - `items.title` (string, required)

  - `items.direction` (string, required)
    Enum: "DEBIT", "CREDIT"

  - `items.pocket_id` (string, required)
    The pocket associated with the transaction

  - `items.customer_id` (string, required)
    The customer associated with the transaction

  - `items.remittance_information` (any)

  - `items.remittance_information.unstructured` (string)
    Unstructured information provided by the originator of the transaction.

  - `items.type` (string, required)

  - `items.company_name` (string, required)

  - `items.company_entry_description` (any)

  - `items.individual_identification_number` (any)

  - `items.trace_number` (any)

  - `items.ach_id` (any)
    Deprecated. Use `ach_transfer_id`. The ID of the transfer object associated with this transaction. This field will be not be populated for originations before July 2024.

  - `items.ach_transfer_id` (any)
    The ID of the ACH transfer behind this transaction: the ACH receiving for an incoming ACH transaction, the ACH origination for an origination, or the returned ACH origination for an ACH return. Null for incoming ACH transactions created before October 2026, and for ACH returns created before November 2026.

  - `items.ach_direction` (string, required)
    Enum: "RECEIVING", "ORIGINATION"

  - `items.portal_id` (any)

  - `items.return_details` (any)
    Why the receiving bank returned the ACH origination this transaction reverses. Set only on an ACH return; null on every other ACH transaction.

  - `items.return_details.return_code` (string, required)
    The return code the receiving bank sent, for example `R03`.

  - `items.return_details.return_reason` (string, required)
    The standard Nacha reason for `return_code`, for example `No Account/Unable to Locate Account`. The same text for every return with that code.

  - `items.location` (any)

  - `items.location.street_address` (string, required)

  - `items.location.city` (string, required)

  - `items.location.state` (any)

  - `items.location.country` (string, required)

  - `items.counterparty` (any)

  - `items.terminal_id` (any)

  - `items.merchant_type` (any)

  - `items.merchant_code` (any)
    The merchant category code (MCC) of the card acceptor, as reported by the card network. `merchant_type` is its human-readable name. Null when the network did not supply one.

  - `items.pre_authorization` (boolean, required)

  - `items.issue_id` (any)

  - `items.period` (any)
    Set if cash back for a certain card period.

  - `items.card_id` (any)
    The ID of the card related to the credit.

  - `items.fee_type` (string, required)

  - `items.reference_transaction_id` (any, required)
    For reverse postings, the identity of the transaction being reversed.

  - `items.blockchain_network` (string, required)

  - `items.counterparty_wallet_address` (string, required)

  - `items.counterparty_name` (any)

  - `items.end_to_end_identification` (any)

  - `items.transaction_hash` (any)

  - `items.on_us_transfer_id` (string, required)

  - `items.on_us_transfer_type` (string, required)

  - `items.associated_pocket_id` (any)
    The id of the pocket on the other half of INTERNAL_REALLOCATION ON_US transfer.

  - `items.reference_number` (string, required)

  - `items.wire_id` (any, required)

  - `items.wire_type` (string, required)
    The kind of wire activity this transaction represents: `PAYMENT` for an ordinary incoming or outgoing wire, `REVERSAL` for the reversal of a wire that was booked, and `RETURN` for a wire returned by the counterparty bank.
    Enum: "PAYMENT", "REVERSAL", "RETURN"

  - `items.original_wire_id` (any)
    For `RETURN` wires, the ID of the wire that was returned. Null for all other wire types.

  - `object_type` (string)

## Response 401:

  - `401` (unknown)
    The access token is missing, invalid or expired.

## Response 401 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

  - `fields` (any)
    Present only on input validation errors. Each entry identifies one invalid field: `loc` is its location, `msg` is the problem, and `type` is the validation rule that failed.

## Response 403:

  - `403` (unknown)
    `x-jiko-signature` does not match the request, or the access token does not permit this action.

## Response 403 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

  - `fields` (any)
    Present only on input validation errors. Each entry identifies one invalid field: `loc` is its location, `msg` is the problem, and `type` is the validation rule that failed.

## Response 422:

  - `422` (unknown)
    Validation Error

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)