v1
latestOpenAPI 3.1.02026-07-2617501.1 MBList the Motive Cards of your company
Query parameters
Specify the last 4 digits of the card for which you want to view the details such as status, assigned to, and spend profile. <b>NOTE</b>: Only 4 digits are allowed.
Filter the response of the endpoint by specifying the status of the card. <b>Allowed Values</b>: <ul><li><b>active</b>: Denotes all the active and unlocked cards.</li><li><b>active_locked</b>: Denotes all the cards that are active and currently locked.</li><li><b>suspended</b>: Denotes all the cards that are currently suspended.</li><li><b>unassigned</b>: Denotes all the cards that are currently not assigned to any user.</li><li><b>terminated</b>: Denotes all the cards that are deactivated.</li></ul>
Specify the ID of the driver for whom you want to see the information of the Motive Card.
Specify the ID of the vehicle(s), for which you want to see the information of the Motive Cards.
Specify the ID of the SPEND CONTROL PROFILE This allows you to view the spend patterns of the drivers.
Mobile based unlock allows you to unlock a locked Motive Card through either SMS or through the Motive Driver App. Specify if you want to view the responses of the endpoint that includes mobile_based_unlock. Allowed Values: <ul><li><b>TRUE</b>: Displays results that include cards with mobile based unlocking feature.</li><li><b>FALSE</b>: Displays results that do not include cards with mobile based unlock feature.</li></ul>
Proximity based decline is the process of declining card transactions that happen either very far from the vehicle or in an unexpected location based on the current trip. Specify the bool values to filter the response accordingly. <ul><li><b>TRUE</b>: Include all the cards that have the proximity based decline feature enabled. </li><li><b>FALSE</b>: Include cards that have the proximity based decline feature disabled.</li></ul>
Transaction requirements allow only authorized drivers or users to input the required details before a transaction. Specify if you want the endpoint response to include cards that have transaction_requirements. Allowed values are: <ul><li><b>transaction_requirements_enabled</b></li><li><b>transaction_requirements_disabled</b></li></ul>.
Specify the IDs of the group for whom you want to view the Motive Cards.
Specify the number of responses per page.
Specify the page number of the given responses.
Response
200
Example response
{
"cards": [
{
"id": "478304bb-d1b0-4ec9-95b0-71942c493d9d",
"last_four_digits": "2039",
"display_card_id": "93",
"name_line_1": "Driver 93",
"name_line_2": "Motive Internal Engineering Fleet",
"status": "active",
"created_at": "2022-11-13T16:37:26.684Z",
"updated_at": "2025-01-07T12:19:54.003Z",
"assigned_to": {
"entity_type": "driver",
"entity_id": 3800458,
"entity_name": "Anant Urala"
},
"security_settings": {
"status": "active",
"is_locked": true
},
"spend_control_profile": {
"id": "761097c1-cfe7-4f04-b519-d6a7ef939021",
"name": "Time limits setup test",
"created_at": "2024-01-02T12:01:26.578Z",
"updated_at": "2024-12-19T09:23:25.576Z",
"spend_limits": {
"daily_limit_in_cents": 350000,
"weekly_limit_in_cents": 400000,
"daily_withdrawal_limit_in_cents": 3000,
"weekly_withdrawal_limit_in_cents": 4000,
"atm_withdrawal_enabled": true,
"enable_days": [
"mon"
],
"enable_start_time": "00:00",
"enable_end_time": "23:59",
"created_by": 2428787
},
"spend_categories": [
"Fuel pump"
]
}
}
],
"pagination": {
"per_page": 25,
"page_no": 1,
"total": 230
}
}