--- agentTools: projectIndex: https://developer-docs.gomotive.com/llms.txt --- # List all the Motive Card transactions (v2) **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.

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 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. *** # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Motive", "version": "1.0" }, "servers": [ { "url": "https://api.gomotive.com" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "x-api-key" } } }, "security": [ { "sec0": [] } ], "paths": { "/motive_card/v2/transactions": { "get": { "summary": "List all the Motive Card transactions (v2)", "description": "", "operationId": "list-all-the-motive-card-transactions-v2", "parameters": [ { "name": "X-Time-Zone", "in": "header", "description": "Specify the timezone for formatting the timestamps.", "required": true, "schema": { "type": "string" } }, { "name": "X-API-Key", "in": "header", "description": "Specify the API key of the company for which you are using this endpoint.", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "description": "Specify the authorisation to invoke the endpoint. NOTE: Specify either the API Key or the Authorization.", "schema": { "type": "string" } }, { "name": "driver_ids[]", "in": "query", "description": "Specify the driver IDs for whom you want to fetch the Motive card transactions.", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "vehicle_ids[]", "in": "query", "description": "Specify a list of the vehicles for which you are checking the Motive card transactions.", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "date_range_filter_type", "in": "query", "description": "Narrow your search range by specifying either the date range or a transaction time. Allowed values are transaction_time, or posted_at.", "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "description": "Specify the start date from which you want to list out the transactions. Default: 1 Week ago.", "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "description": "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.", "schema": { "type": "string", "format": "date" } }, { "name": "last_four_digits", "in": "query", "description": "Specify the Motive card's last 4 digits to fetch the details pertaining to that particular card.", "schema": { "type": "string" } }, { "name": "card_id", "in": "query", "description": "Specify the ID of the card for which you want to view all the transactions.", "schema": { "type": "string" } }, { "name": "transaction_status_list", "in": "query", "description": "Filter by a specific transaction that you want to check for the Motive card transactions. Allowed values are ", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "sort_direction", "in": "query", "description": "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.", "schema": { "type": "string", "default": "desc" } }, { "name": "page_number", "in": "query", "description": "Specify the page number to view the transactions.", "schema": { "type": "string", "default": "1" } }, { "name": "per_page", "in": "query", "description": "Denotes the number of results per page. Default is 1000 per page.", "schema": { "type": "string", "default": "1000" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "List all the Motive Card transactions (v2)": { "value": "{\n \"transactions\": [\n {\n \"transaction\": {\n \"id\": \"d96ec3f5-6e9c-4550-8824-c6e5e4ff55dd\",\n \"transaction_status\": \"posted\",\n \"transaction_time\": \"2023-02-01T07:00:01.000Z\",\n \"posted_at\": \"2023-02-01T07:00:01.000Z\",\n \"updated_at\": \"2023-02-01T07:00:00.000Z\",\n \"transaction_dispute\": null,\n \"driver_id\": 4,\n \"vehicle_id\": 2,\n \"last_four_digits\": \"1234\",\n \"invoice_number\": null,\n \"authorized_amount_in_micros\": 10000000,\n \"total_rebate_in_micros\": 0,\n \"total_amount_before_rebate_in_micros\": 5660000,\n \"total_amount_after_rebate_in_micros\": 5660000,\n \"merchant_info\": {\n \"name\": \"Shell\",\n \"city\": \"Berkeley\",\n \"state\": \"CA\",\n \"street\": \"111 Main St\",\n \"country\": \"USA\",\n \"zip_code\": \"94702\",\n \"address\": \"111 Main St\",\n \"full_address\": \"111 Main St, Berkeley, CA 94702, USA\"\n },\n \"decline_reason_code\": null,\n \"decline_reason\": null,\n \"transaction_reversed_time\": null,\n \"pre_transaction_metadata\": {\n \"odometer_reading\": 120088,\n \"odometer_unit\": \"km\",\n \"custom_info\": [\n {\n \"name\": \"project_id_1\",\n \"value_type\": \"free_text\",\n \"values\": null,\n \"current_value\": \"random value\"\n },\n {\n \"name\": \"optional_note\",\n \"value_type\": \"free_text\",\n \"values\": null,\n \"current_value\": \"Optional field value\"\n },\n {\n \"name\": \"project_id_2\",\n \"value_type\": \"single_select\",\n \"values\": [\n 123,\n 234\n ],\n \"current_value\": \"123\"\n }\n ]\n },\n \"post_transaction_metadata\": {\n \"receipt_available\": true,\n \"comment\": \"testing deferred rebates\",\n \"custom_info\": [\n {\n \"name\": \"optional_project_id_1\",\n \"value_type\": \"free_text\",\n \"values\": null,\n \"current_value\": \"random value\"\n },\n {\n \"name\": \"optional_note2\",\n \"value_type\": \"free_text\",\n \"values\": null,\n \"current_value\": \"Optional field value\"\n },\n {\n \"name\": \"project_id_3\",\n \"value_type\": \"single_select\",\n \"values\": [\n 123,\n 234\n ],\n \"current_value\": \"123\"\n }\n ]\n },\n \"order_items\": [\n {\n \"quantity\": 5,\n \"unit_price\": 50.5,\n \"gross_amount\": 252.5,\n \"product_type\": \"Diesel\",\n \"unit_of_measure\": \"gal\",\n \"rebate_amount_in_micros\": 0\n },\n {\n \"quantity\": 10,\n \"unit_price\": 5,\n \"gross_amount\": 50,\n \"product_type\": \"Misc. (non-fuel)\",\n \"unit_of_measure\": null,\n \"rebate_amount_in_micros\": 0\n }\n ],\n \"currency\": null\n }\n }\n ],\n \"company_id\": 4,\n \"pagination\": {\n \"per_page\": 50,\n \"page_no\": 1,\n \"total\": 1\n }\n}" } }, "schema": { "type": "object", "properties": { "transactions": { "type": "array", "items": { "type": "object", "properties": { "transaction": { "type": "object", "properties": { "id": { "type": "string", "example": "d96ec3f5-6e9c-4550-8824-c6e5e4ff55dd" }, "transaction_status": { "type": "string", "example": "posted" }, "transaction_time": { "type": "string", "example": "2023-02-01T07:00:01.000Z" }, "posted_at": { "type": "string", "example": "2023-02-01T07:00:01.000Z" }, "updated_at": { "type": "string", "example": "2023-02-01T07:00:00.000Z" }, "transaction_dispute": {}, "driver_id": { "type": "integer", "example": 4, "default": 0 }, "vehicle_id": { "type": "integer", "example": 2, "default": 0 }, "last_four_digits": { "type": "string", "example": "1234" }, "invoice_number": {}, "authorized_amount_in_micros": { "type": "integer", "example": 10000000, "default": 0 }, "total_rebate_in_micros": { "type": "integer", "example": 0, "default": 0 }, "total_amount_before_rebate_in_micros": { "type": "integer", "example": 5660000, "default": 0 }, "total_amount_after_rebate_in_micros": { "type": "integer", "example": 5660000, "default": 0 }, "merchant_info": { "type": "object", "properties": { "name": { "type": "string", "example": "Shell" }, "city": { "type": "string", "example": "Berkeley" }, "state": { "type": "string", "example": "CA" }, "street": { "type": "string", "example": "111 Main St" }, "country": { "type": "string", "example": "USA" }, "zip_code": { "type": "string", "example": "94702" }, "address": { "type": "string", "example": "111 Main St" }, "full_address": { "type": "string", "example": "111 Main St, Berkeley, CA 94702, USA" } } }, "decline_reason_code": {}, "decline_reason": {}, "transaction_reversed_time": {}, "pre_transaction_metadata": { "type": "object", "properties": { "odometer_reading": { "type": "integer", "example": 120088, "default": 0 }, "odometer_unit": { "type": "string", "example": "km" }, "custom_info": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "project_id_1" }, "value_type": { "type": "string", "example": "free_text" }, "values": {}, "current_value": { "type": "string", "example": "random value" } } } } } }, "post_transaction_metadata": { "type": "object", "properties": { "receipt_available": { "type": "boolean", "example": true, "default": true }, "comment": { "type": "string", "example": "testing deferred rebates" }, "custom_info": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "optional_project_id_1" }, "value_type": { "type": "string", "example": "free_text" }, "values": {}, "current_value": { "type": "string", "example": "random value" } } } } } }, "order_items": { "type": "array", "items": { "type": "object", "properties": { "quantity": { "type": "integer", "example": 5, "default": 0 }, "unit_price": { "type": "number", "example": 50.5, "default": 0 }, "gross_amount": { "type": "number", "example": 252.5, "default": 0 }, "product_type": { "type": "string", "example": "Diesel" }, "unit_of_measure": { "type": "string", "example": "gal" }, "rebate_amount_in_micros": { "type": "integer", "example": 0, "default": 0 } } } }, "currency": {} } } } } }, "company_id": { "type": "integer", "example": 4, "default": 0 }, "pagination": { "type": "object", "properties": { "per_page": { "type": "integer", "example": 50, "default": 0 }, "page_no": { "type": "integer", "example": 1, "default": 0 }, "total": { "type": "integer", "example": 1, "default": 0 } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Invalid Time Zone": { "value": "{\n \"error_message\": \"invalid time zone\",\n}" } } } } }, "403": { "description": "403", "content": { "application/json": { "examples": { "Invalid API Key": { "value": "{\n \"error_message\": \"invalid api key\",\n}" }, "Invalid Token": { "value": "{\n \"error_message\": \"invalid token\",\n}" }, "Expired Token": { "value": "{\n \"error_message\": \"token expired\",\n}" }, "Request Denied": { "value": "{\n \"error_message\": \"the resouce owner or authorization server denied the request\",\n}" }, "Card Issue": { "value": "{\n \"error_message\": \"fleet card not enabled for company\",\n}" } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Company Not Found": { "value": "{\n \"error_message\": \"company not found\",\n}" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "66acf64a829e88001980fbf2:68e4b4bf4ca07113e3b0d65c" } ```