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

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.

---

Supported "product_types"

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

---