--- agentTools: projectIndex: https://developer-docs.gomotive.com/llms.txt --- # Fetch the details of a Motive Card **Purpose**: View detailed info of a particular Motive Card. This endpoint fetches details such as **display\_card\_id**, **status**, **last\_transaction\_performed\_at**, **security\_settings**, **spend\_control\_profile**, and **vehicle\_proximity\_based\_decline\_settings**. *** ## Response Parameters ### cards * **Type**: Array of Objects * **Description**: Contains a list of card objects. ### id * **Type**: String (UUID) * **Description**: The unique identifier of the card. ### last\_four\_digits * **Type**: String * **Description**: The last four digits of the card number. ### display\_card\_id * **Type**: String * **Description**: A display-friendly identifier for the card. ### name\_line\_1 * **Type**: String * **Description**: The first line of the cardholder’s name (e.g., driver name). ### name\_line\_2 * **Type**: String * **Description**: The second line of the cardholder’s name (e.g., company name). ### status * **Type**: String * **Description**: The current status of the card (e.g., `active`). ### created\_at * **Type**: String (DateTime) * **Description**: The timestamp indicating when the card was created. ### updated\_at * **Type**: String (DateTime) * **Description**: The timestamp indicating when the card information was last updated. ### assigned\_to * **Type**: Object * **Description**: Information about the entity (e.g., driver) to whom the card is assigned. ### entity\_type * **Type**: String * **Description**: The type of entity to which the card is assigned (e.g., `driver`). ### entity\_id * **Type**: Integer * **Description**: The unique identifier of the assigned entity. ### entity\_name * **Type**: String * **Description**: The name of the assigned entity. ### security\_settings * **Type**: Object * **Description**: Security-related settings for the card. ### status * **Type**: String * **Description**: The security status of the card (e.g., `active`). ### is\_locked * **Type**: Boolean * **Description**: Indicates if the card is currently locked. ### unlocked\_till * **Type**: String (DateTime) or null * **Description**: The time until which the card remains unlocked, if applicable. ### vehicle\_proximity\_based\_decline\_settings * **Type**: Boolean * **Description**: Whether vehicle proximity-based declines are enabled or not. ### spend\_control\_profile * **Type**: Object * **Description**: Contains the spending control profile details for the card. ### id * **Type**: String (UUID) * **Description**: The unique identifier of the spend control profile. ### name * **Type**: String * **Description**: The name of the spend control profile. ### is\_default * **Type**: Boolean * **Description**: Indicates if this profile is the default profile. ### created\_at * **Type**: String (DateTime) * **Description**: The timestamp when the profile was created. ### updated\_at * **Type**: String (DateTime) * **Description**: The timestamp when the profile was last updated. ### spend\_limits * **Type**: Object * **Description**: Detailed spending limits set within the profile. ### daily\_limit\_in\_cents * **Type**: Integer or null * **Description**: The daily spending limit in cents. ### weekly\_limit\_in\_cents * **Type**: Integer or null * **Description**: The weekly spending limit in cents. ### monthly\_limit\_in\_cents * **Type**: Integer or null * **Description**: The monthly spending limit in cents. ### transaction\_limit\_in\_cents * **Type**: Integer or null * **Description**: The per-transaction spending limit in cents. ### billing\_cycle\_spend\_limit\_in\_cents * **Type**: Integer or null * **Description**: The spending limit for the current billing cycle in cents. ### daily\_withdrawal\_limit\_in\_cents * **Type**: Integer or null * **Description**: The daily withdrawal limit in cents (e.g., at ATMs). ### weekly\_withdrawal\_limit\_in\_cents * **Type**: Integer or null * **Description**: The weekly withdrawal limit in cents. ### atm\_withdrawal\_enabled * **Type**: Boolean * **Description**: Indicates whether ATM withdrawals are allowed. ### enable\_days * **Type**: Array of Strings * **Description**: The days of the week when the card can be used (e.g., `["mon", "tue", ...]`). ### enable\_start\_time * **Type**: String (Time) * **Description**: The start time (in 24-hour format) from which card usage is enabled. ### enable\_end\_time * **Type**: String (Time) * **Description**: The end time (in 24-hour format) until which card usage is enabled. ### created\_by * **Type**: Integer or null * **Description**: The ID of the user who created these spend limits. ### spend\_categories * **Type**: Array of Strings * **Description**: The spending category for this profile (e.g., `["Fuel pump"]`). *** # 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/v1/cards/{card_id}": { "get": { "summary": "Fetch the details of a Motive Card", "description": "", "operationId": "fetch-the-details-of-a-specific-motive-card", "parameters": [ { "name": "card_id", "in": "path", "description": "Specify the Public Card ID of the Motive Card (UUID), for which you want to view a detailed info.", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Fetch the details of a specific Motive Card": { "value": " {\"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\",\"last_transaction_performed_at\":\"2024-09-26T18:06:13.785Z\",\"number_of_transactions\":27,\"assigned_to\":{\"entity_type\":\"driver\",\"entity_id\":3800458,\"entity_name\":\"Anant Urala\"},\"security_settings\":{\"status\":\"active\",\"is_locked\":true,\"unlocked_till\":null,\"vehicle_proximity_based_decline_settings\":false},\"spend_control_profile\":{\"id\":\"761097c1-cfe7-4f04-b519-d6a7ef939021\",\"name\":\"Time limits setup test\",\"is_default\":false,\"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,\"monthly_limit_in_cents\":null,\"transaction_limit_in_cents\":null,\"billing_cycle_spend_limit_in_cents\":null,\"daily_withdrawal_limit_in_cents\":3000,\"weekly_withdrawal_limit_in_cents\":4000,\"atm_withdrawal_enabled\":true,\"enable_days\":[\"mon\",\"tue\",\"wed\",\"thu\",\"fri\"],\"enable_start_time\":\"00:00\",\"enable_end_time\":\"23:59\",\"created_by\":2428787},\"spend_categories\":[\"Fuel pump\"]}}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "478304bb-d1b0-4ec9-95b0-71942c493d9d" }, "last_four_digits": { "type": "string", "example": "2039" }, "display_card_id": { "type": "string", "example": "93" }, "name_line_1": { "type": "string", "example": "Driver 93" }, "name_line_2": { "type": "string", "example": "Motive Internal Engineering Fleet" }, "status": { "type": "string", "example": "active" }, "last_transaction_performed_at": { "type": "string", "example": "2024-09-26T18:06:13.785Z" }, "number_of_transactions": { "type": "integer", "example": 27, "default": 0 }, "assigned_to": { "type": "object", "properties": { "entity_type": { "type": "string", "example": "driver" }, "entity_id": { "type": "integer", "example": 3800458, "default": 0 }, "entity_name": { "type": "string", "example": "Anant Urala" } } }, "security_settings": { "type": "object", "properties": { "status": { "type": "string", "example": "active" }, "is_locked": { "type": "boolean", "example": true, "default": true }, "unlocked_till": {}, "vehicle_proximity_based_decline_settings": { "type": "boolean", "example": false, "default": true } } }, "spend_control_profile": { "type": "object", "properties": { "id": { "type": "string", "example": "761097c1-cfe7-4f04-b519-d6a7ef939021" }, "name": { "type": "string", "example": "Time limits setup test" }, "is_default": { "type": "boolean", "example": false, "default": true }, "created_at": { "type": "string", "example": "2024-01-02T12:01:26.578Z" }, "updated_at": { "type": "string", "example": "2024-12-19T09:23:25.576Z" }, "spend_limits": { "type": "object", "properties": { "daily_limit_in_cents": { "type": "integer", "example": 350000, "default": 0 }, "weekly_limit_in_cents": { "type": "integer", "example": 400000, "default": 0 }, "monthly_limit_in_cents": {}, "transaction_limit_in_cents": {}, "billing_cycle_spend_limit_in_cents": {}, "daily_withdrawal_limit_in_cents": { "type": "integer", "example": 3000, "default": 0 }, "weekly_withdrawal_limit_in_cents": { "type": "integer", "example": 4000, "default": 0 }, "atm_withdrawal_enabled": { "type": "boolean", "example": true, "default": true }, "enable_days": { "type": "array", "items": { "type": "string", "example": "mon" } }, "enable_start_time": { "type": "string", "example": "00:00" }, "enable_end_time": { "type": "string", "example": "23:59" }, "created_by": { "type": "integer", "example": 2428787, "default": 0 } } }, "spend_categories": { "type": "array", "items": { "type": "string", "example": "Fuel pump" } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "_id": "66acf64a829e88001980fbf2:678a5e5dab88c00075511fda" } ```