API Reference
Log In

List all the Motive Card transactions (v2)

get
https://api.gomotive.com/motive_card/v2/transactions

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.


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.

rebate_items

  • Type: Array of Objects
  • Description: Rebate details of items in the current 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 items object details

product_type

  • Type: String

  • Description: Type of the product that is considered under the rebate.

rebate_amount

  • Type: Float
  • Description: Rebate amount applied to the product type 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

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

transaction_dispute

  • Type: Object

  • Description: Dispute details.

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. Default: 1 Week ago.

date

Specify an end date before which you want to check the transactions. Default: Current date. NOTE: Start Date and End Date are optional. If using, enter both the values. Else, leave them both blank.

string

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

string

Specify the ID of the card for which you want to view all the transactions.

transaction_status_list
array of strings

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
  • disputed_closed

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

string
Defaults to 1

Specify the page number to view the transactions.

string
Defaults to 1000

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

Headers
string
required

Specify the timezone for formatting the timestamps.

string
required

Specify the API key of the company for which you are using this endpoint.

string

Specify the authorisation to invoke the endpoint. NOTE: Specify either the API Key or the Authorization.

Responses

Updated about 2 months ago

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