Purpose: The Motive Cards – List all transactions (v2) endpoint returns a paginated collection of card transactions across your fleet, enabling finance and operations teams to audit spend, reconcile charges, and monitor usage in real time.

Supported product_types

The order_items[].product_type field on Motive Card transactions may return any of the values below. This reference applies to both the v1 and v2 transaction endpoints. The Category column is for readability only — it is not returned by the API; only the individual Product Type value is.

Note: This category set may evolve over time as new product_type values are added. There is currently no change-log or versioning mechanism for these additions, and filtering transactions by product_type is currently not supported on the public APIs.

Response Parameters

company_id

• Type: Integer

• Description: Unique identifier of the company.

transactions

• Type: Array of Objects

• Description: List of transactions associated with the account.

id

• Type: String

• Description: Unique identifier for the transaction.

transaction_status

• Type: String

• Description: Status of the transaction (e.g., "posted").

transaction_type

• Type: String

• Description: Type of the transaction — value can be one of: purchase, fee, credit, or adjustment.

transaction_time

• Type: String (Date-Time)

• Description: Timestamp when the transaction occurred.

posted_at

• Type: String (Date-Time)

• Description: Timestamp when the transaction was posted.

updated_at

• Type: String (Date-Time)

• Description: Timestamp when the transaction was last updated.

transaction_reversed_time

• Type: String (Date-Time)

• Description: Timestamp when the transaction was reversed, if applicable.

driver_id

• Type: Integer

• Description: ID of the driver associated with the transaction.

vehicle_id

• Type: Integer

• Description: ID of the vehicle associated with the transaction (null if not applicable).

last_four_digits

• Type: String

• Description: Last four digits of the card used in the transaction.

card_id

• Type: String

• Description: Unique identifier of the card used in the transaction.

invoice_number

• Type: String

• Description: Invoice number for the transaction.

authorized_amount

• Type: Float

• Description: Authorized amount in dollars.

total_rebate

• Type: Float

• Description: Total rebate amount applied to the transaction in dollars.

total_amount_before_rebate

• Type: Float

• Description: Total amount before applying the rebate, in dollars.

total_amount

• Type: Float

• Description: Total amount after applying the rebate, in dollars. In the case of a fee, credit, or adjustment, the impacted amount is surfaced in this field.

decline_reason_code

• Type: String

• Description: Code indicating the reason for transaction decline, if applicable.

decline_reason

• Type: String

• Description: Description of the reason for transaction decline, if applicable.

currency

• Type: String

• Description: Currency used in the transaction (e.g., "USD").

order_items

• Type: Array of Objects

• Description: List of items involved in the transaction.

quantity

• Type: Float

• Description: Quantity of the item.

unit_price

• Type: Float

• Description: Unit price of the item.

gross_amount

• Type: Float

• Description: Gross amount of the item in dollars.

product_type

• Type: String

• Description: Type of the product (e.g., "Cash", "ATM fee").

unit_of_measure

• Type: String

• Description: Unit of measurement for the item.

rebate_amount

• Type: Float

• Description: Rebate amount applied to the item in dollars.

merchant_info

• Type: Object

• Description: Information about the merchant where the transaction occurred.

Merchant Info object details

name

• Type: String

• Description: Name of the merchant (e.g., "Marqeta Storefront").

city

• Type: String

• Description: City where the merchant is located (e.g., "St. Petersburg").

state

• Type: String

• Description: State where the merchant is located (e.g., "CA").

street

• Type: String

• Description: Street address of the merchant.

country

• Type: String

• Description: Country where the merchant is located (e.g., "USA").

zip_code

• Type: String

• Description: ZIP code of the merchant's location (e.g., "33705").

address

• Type: String

• Description: Full address of the merchant.

full_address

• Type: String

• Description: Full formatted address of the merchant.

pre_transaction_metadata

• Type: Object

• Description: Metadata before the transaction occurred.

odometer_reading

• Type: Integer

• Description: Odometer reading before the transaction.

odometer_unit

• Type: String

• Description: Unit of the odometer reading (e.g., "km").

custom_info

• Type: Array of Objects
• Description: A collection of custom data fields (like Project IDs or Notes) associated with the transaction.

name

• Type: String
• Description: The label or identifier for the custom field (e.g., "project_id_1", "optional_note").

value_type

• Type: String
• Description: Defines the format of the data. Common values include:
  • free_text: Allows for any alphanumeric input.
  • single_select: Provides a pre-defined list of options for the user to choose from.

values

• Type: Array or Null
• Description: If the value_type is single_select, this contains an array of valid options (e.g., [123, 234]). For free_text, this usually returns null.

current_value

• Type: String
• Description: The actual data entered or selected for this specific transaction (e.g., "random value" or "123").

post_transaction_metadata

• Type: Object

• Description: Metadata after the transaction occurred.

receipt_available

• Type: Boolean

• Description: Whether a receipt is available for the transaction.

comment

• Type: String

• Description: Additional comments related to the transaction.

transaction_dispute

• Type: Object

• Description: Dispute details.

---