List of all the Motive Card transactions

Purpose: Use this API to fetch a list of all the Motive card transactions that happened at your organisation. This API fetches the details of the transactions by the drivers, as well as other employees who use the Motive card for their daily expenses.

You can narrow down your search by using the query parameters. Refer to the query parameters section for more info.

📘

NOTE

The query parameters start_dateand end_date, must be used together. They are not mutually exclusive.

Response Parameters

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_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_dispute

  • Type: String
  • Description: Dispute status of the transaction, if any.

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.

invoice_number

  • Type: String
  • Description: Invoice number for the transaction.

authorized_amount_in_micros

  • Type: Integer
  • Description: Authorized amount in micros (1 micro = 0.000001 currency unit).

total_rebate_in_micros

  • Type: Integer
  • Description: Total rebate amount applied to the transaction in micros.

total_amount_before_rebate_in_micros

  • Type: Integer
  • Description: Total amount before applying the rebate, in micros.

total_amount_after_rebate_in_micros

  • Type: Integer
  • Description: Total amount after applying the rebate, in micros.

merchant_info

  • Type: Object

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

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.

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.

transaction_reversed_time

  • Type: String (Date-Time)
  • Description: Timestamp when the transaction was reversed, if applicable.

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
  • Description: Custom metadata associated with the transaction.

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.

order_items

  • Type: Array of Objects

  • Description: List of items involved in the transaction.

quantity

  • Type: Integer
  • Description: Quantity of the item.

unit_price

  • Type: Integer
  • Description: Unit price of the item.

gross_amount

  • Type: Integer
  • Description: Gross amount of the item in micros.

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_in_micros

  • Type: Integer
  • Description: Rebate amount applied to the item in micros.

currency

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

Supported "product_types"

Here is a list of all the supported product_types which may appear in your Motive Card transactions.

Product TypeIncludes
MaintenanceAutomotive GlassAviation Maintenance, Brake Fluid, De-icing, Miscellaneous Labor, Miscellaneous Parts, Miscellaneous Repairs, Motor Oil, Solvent, TBA(tire batteries accessories), Transmission Service
GasolineE85 (Ethanol 85%), Ethanol Regular Leaded, Ethanol Unleaded Mid Grade (88 or 89 octane), Ethanol Unleaded Premium (90 or 91 octane), Ethanol Unleaded Regular (86 or 87 octane), Ethanol Unleaded Super (92 to 94 octane), Gasohol, Methanol Regular Leaded, Methanol Unleaded Mid Grade (88 or 89 octane), Methanol Unleaded Premium (90 or 91 octane), Methanol Unleaded Regular (86 or 87 octane), Methanol Unleaded Super (92 to 94 octane), Regular Leaded Gasoline, Unleaded Mid Grade (88 or 89 octane), Unleaded Mid Grade Reformulated (88 or 89 octane), Unleaded Premium (90 or 91 octane), Unleaded Reformulated (86 or 87 octane), Unleaded Regular (85 to 87 octane), Unleaded Super (92 to 94 octane)
Tires
Miscellaneous FuelAviation 100 Octane, Aviation Fuel, Biodiesel (Non-Taxable), Compressed Natural Gas, Electric Vehicle Charge Level 1: 110V, Electric Vehicle Charge Level 2: 240V, Electric Vehicle Charge Level 3: 480V, Jet Fuel, Kerosene, Liquid Natural Gas, Liquid Propane Gas (LPG), M85 (Methanol 85%), Marine Fuel, Miscellaneous Fuel, Racing Fuel, White Gas
CashCash Advance
DEFDiesel Exhaust Fluid (DEF), Diesel exhaust fluid (DEF), Diesel exhaust fluid (DEF) Dispensed
Reefer FuelDyed Diesel, Reefer
FoodAviation Catering, Beer/Wine, Milk/Juice, Miscellaneous Beverage, Miscellaneous food/Grocery, Restaurant, Soda
DieselBiodiesel, Diesel, Diesel Premium, Ultralow Sulfur Diesel (ULSD)
OtherAPU or Aircraft Jump Start, Aircraft Cleaning, Automotive Accessories, Aviation Accessories, Batteries, Boat Service, Call Out Fee, Cargo Handling, Charter Fees, Cigarettes/Tobacco, Communications Fees, Driver Rewards Promo, Engine Service, Flight Planning/Weather Fees, Ground Handling, Health/Beauty Aid, Instruction Fee, Landing Fee, Miscellaneous Aviation, Miscellaneous Other, Oil Change, Plane Rental, Ramp Fee
Parking and TollsTiedown and Hangar
Car Washes
Towing


Query Params
driver_ids[]
array of int32s

Specify the driver IDs for whom you want to fetch the Motive card transactions.

driver_ids[]
vehicle_ids[]
array of int32s

Specify a list of the vehicles for which you are checking the Motive card transactions.

vehicle_ids[]
string

Narrow your search range by specifying either the date range or a transaction time. Allowed values are <transaction_time>, or <posted_at>.

date

Specify the start date from which you want to list out the transactions.

date

Specify an end date before which you want to check the transactions.

string

Specify the Motive card's last 4 digits to fetch the details pertaining to that particular card.

string

Filter by a specific transaction that you want to check for the Motive card transactions. Allowed values are Posted, Pending, Reversed, Refunded, Declined, Disputed_opened, and Disputed_closed.

string
Defaults to desc

Sort the Motive card transactions either in an ascending order or a descending order based on the date range filter type. Default Value: Descending. Allowed values are: asc, desc.

int32
Defaults to 1

Denotes the page number.

int32
Defaults to 1000

Denotes the number of results per page. Default is 1000 per page.

Responses

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json