API Reference
Log In

List all the Motive Card transactions

get
https://api.gomotive.com/motive_card/v1/transactions
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

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.

Category Product Type It Includes
Fuel Gasoline E85 (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)
DieselBiodiesel, Diesel, Diesel Premium, Ultralow Sulfur Diesel (ULSD)
Reefer fuelDyed Diesel, Reefer
DEFDiesel Exhaust Fluid (DEF), Diesel exhaust fluid (DEF) Dispensed
Misc fuelAviation 100 Octane, Aviation Fuel, Biodiesel (Non-Taxable), Compressed Natural Gas, Jet Fuel, Kerosene, Liquid Natural Gas, Liquid Propane Gas (LPG), M85 (Methanol 85%), Marine Fuel, Racing Fuel, White Gas. Also returned as "misc. fuel" / "misc_fuel" — same category, normalized.
Electric vehicle chargingElectric Vehicle Charge Level 1: 110V, Electric Vehicle Charge Level 2: 240V, Electric Vehicle Charge Level 3: 480V.
Fuel station purchases
Fuel apps
Fleet services Maintenance Automotive Glass, Aviation Maintenance, Brake Fluid, De-icing, Miscellaneous Labor, Miscellaneous Parts, Miscellaneous Repairs, Motor Oil, Solvent, TBA (tire batteries accessories), Transmission Service
Tires
Car washes
Parking & tollsTiedown and Hangar
Towing
Travel Travel
Air travel
Car rentals
Lodging
Taxis and rideshares
Travel expenses
Buses and trains
Business & office Business & professional services
Internet & phone services
Office supplies
Computer hardware and software
Advertising
Utilities
Insurance
Gifts
Rent
Merchandise & services Food Aviation Catering, Beer/Wine, Milk/Juice, Miscellaneous Beverage, Miscellaneous food/Grocery, Restaurant, Soda
Supermarkets & general merchandise
Hardware stores
Books & newspapers
Medical
Training and education
Entertainment
Clubs & memberships
Government services
Misc / fallback Misc
Misc. (non-fuel)
CashCash Advance
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
Adjustments & fees Merchant discount
Promo Rebate
Monthly Fee
Late Fee
Shipping Fee
Foreign Transaction Fee

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 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. One of: pending, completed, posted, declined, reversed, refund, refund_pending, refund_declined, refund_reversed, initiated, error, failed. Fees and credits are completed or reversed.

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).

asset_id

  • Type: Integer

  • Description: ID of the asset (equipment such as a trailer) 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. Returned only when card IDs are enabled for your account; contact Motive support to enable them.

invoice_number

  • Type: String

  • Description: Invoice number for the transaction.

authorized_amount_in_micros

  • Type: Integer

  • Description: Authorized amount, in micros.

total_rebate_in_micros

  • Type: Integer

  • Description: Total rebate applied to the transaction, in micros.

partner_rebates_amount_in_micros

  • Type: Integer

  • Description: The part of the total rebate that is a partner rebate, in micros. Returned only when the rebate breakdown is enabled for your account; contact Motive support to enable it.

company_rebates_amount_in_micros

  • Type: Integer

  • Description: The part of the total rebate that is a company rebate, in micros. Returned only when the rebate breakdown is enabled for your account; contact Motive support to enable it.

promo_rebate_amount_in_micros

  • Type: Integer

  • Description: The part of the total rebate that is a promo rebate, in micros. Returned only when the rebate breakdown is enabled for your account; contact Motive support to enable it.

total_amount_before_rebate_in_micros

  • Type: Integer

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

total_amount_after_rebate_in_micros

  • Type: Integer

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

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_in_micros

  • Type: Integer

  • Description: Rebate applied to the item, in micros.

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.

receipt_images

  • Type: Array of Objects

  • Description: Links to the transaction's receipt images. Each item has a url. Each link works for 7 days. Returned only when receipt links are enabled for your account; contact Motive support to enable them.

custom_info

  • Type: Array of Objects

  • Description: Optional custom fields filled in after the transaction. Same format as custom_info under pre_transaction_metadata. Returned only when optional custom fields are enabled for your account; contact Motive support to enable them.

transaction_dispute

  • Type: Object

  • Description: Dispute details, or null if the transaction is not disputed. Fields: disputed_amount_in_micros (amount disputed), final_amount_won_in_micros (amount credited when the dispute ended), initiated_at (when the dispute started), resolved_at (when it ended), status (dispute status). It can also include credit details: provisional_credit, manual_provisional_credit, reversed_credit, reversed_manual_credit and permanent_credit, each with impacted_amount_in_micros and created_at.

pagination

  • Type: Object

  • Description: Paging details: per_page (results per page), page_no (current page number) and total (total number of transactions that match the request).


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[]
asset_ids[]
array of int32s

Filter by asset IDs. An asset is equipment tracked in Motive, such as a trailer. Works the same way as vehicle_ids[].

asset_ids[]
string
Defaults to transaction_time

Which time the start_date and end_date range applies to. Allowed values: transaction_time (when the transaction happened) or posted_at (when the transaction posted). Default: transaction_time.

date

Start of the time range, as a date and time, for example 2026-10-01T00:00:00. The time is read in the time zone from the X-Time-Zone header (UTC if the header is not sent). Do not add a time zone offset to the value, such as Z or -05:00; the API ignores it. Send start_date and end_date together, or leave both out. If both are left out, the range runs from the start of the day 7 days ago to the end of today.

date

End of the time range, as a date and time, for example 2026-10-31T23:59:59. A date without a time, such as 2026-10-31, means midnight at the start of that day, so that day's transactions are not included. The time is read in the time zone from the X-Time-Zone header (UTC if the header is not sent). Send start_date and end_date together, or leave both out.

string

The last 4 digits of a Motive card, to get only that card's transactions. Must be exactly 4 digits.

string

Filter by card ID. Available only when card IDs are enabled for your account; contact Motive support to enable them.

string

Filter by transaction status. Values are lowercase and must match exactly. To filter by more than one status, repeat the parameter, for example transaction_status_list[]=pending&transaction_status_list[]=posted. Allowed values: posted, pending, completed, declined, reversed, refund, refund_pending, refund_declined, refund_reversed, initiated, error, failed, disputed, dispute_closed. To get the same results as the "Pending" filter in the Motive dashboard, send pending, completed and refund_pending. posted and completed leave out transactions with an open dispute; use disputed to get those. dispute_closed returns transactions whose dispute has ended (cancelled disputes are not included). Leave this parameter out to get every status.

string
Defaults to asc

Sort order, based on the time chosen in date_range_filter_type. Allowed values: asc (oldest first) or desc (newest first). Default: asc.

int32
Defaults to 1

Denotes the page number.

int32
Defaults to 50

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

Headers
string

Optional. The time zone used to read start_date and end_date. If you leave it out, UTC is used. Use one of these values exactly:

  • Newfoundland
  • Atlantic Time (Canada)
  • Eastern Time (US & Canada)
  • Indiana (East)
  • Central Time (US & Canada)
  • Saskatchewan
  • Mountain Time (US & Canada)
  • Arizona
  • Pacific Time (US & Canada)
  • Alaska
  • Hawaii
  • America/Vancouver
  • America/Edmonton

Any other value returns an "invalid time zone" error, even common ones like UTC or America/New_York.

Responses

Updated 7 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 days ago

Did this page help you?