Dealer Status Details

The Motovizion AI API allows you to retrieve the dealer details along with their subscription status.

Endpoint

https://api-v2.motovizion.ai/dealer/status/

Request Format

HTTP Method:

POST

Content-Type:

application/json

Request Body:

The request body should be a JSON object with the following fields:

Parameter	Type	Required	Description
dealer_uuid	String	Yes	The unique identifier for the dealer.

Making an Authorized API Request

curl -X POST https://api-v2.motovizion.ai/dealer/status/ 
-H "X-API-KEY: {API_KEY}" 
-H "Content-Type: application/json" 
-d '{"dealer_uuid": "{DEALER UUID}"}'

Error Responses

If your API key is missing or invalid, the server will respond with an error.

Missing API Key

{
    "status": "error",
    "response": "Invalid API Key"
}

Invalid API Key

{
    "status": "error",
    "response": "Unauthorized"
}

Code Examples

Python

import requests
import json

# API endpoint
url = 'https://api-v2.motovizion.ai/dealer/status/'

# Data to send in the POST request
data = {
    'dealer_uuid': ''
}

# Set the API key
api_key = ''

# Set the headers
headers = {
    'Content-Type': 'application/json',  # Specify JSON content type
    'X-API-Key': api_key,               # Pass the API key in the header
    'Accept': 'application/json'
}

# Send the POST request
try:
    response = requests.post(url, headers=headers, data=json.dumps(data))
    
    # Check for HTTP errors
    response.raise_for_status()

    # Decode and display the API response
    decoded_response = response.json()
    print(json.dumps(decoded_response, indent=4))
except requests.exceptions.RequestException as e:
    print(f"HTTP Request failed: {e}")
    
    

PHP

NodeJS

cURL

Response Data

When you send a valid request to the Motovizion AI API, the response contains structured JSON data. Below is a detailed explanation of the fields included in the response.

{
    "status": "success",
    "response": true,
    "dealer_uuid": "dFxdvajxqap4aFbpBkacHv4RJdp0Irg34QXjzBczecw",
    "dealer_name": "Acme Auto",
    "dealer_status": "active",
    "dept_uuid": "CdFxdvajxqap4aFbpBkacHv4RJdp0Irg34QXjzBczecw",
    "user_uuid": "sad68sdvajxqap4aFbpBkacHv4RJdp0Irg34QXjzBsad678",
    "dealer_logo": "https://mysite.com/logo.jpg",
    "start_date": "2025-05-14",
    "exclusion_list": "TOYOTACARE, 10K, 15K, 20K, Recall"
}

Response Fields

Top-Level Fields:

Field Name	Type	Description
status	String	Indicates the success ("success") or failure ("error") of the request.
response	Boolean	true if the request has a dealer, false if no dealer found.

Dealer Details

Field Name	Type	Description
dealer_uuid	String	ID of requested dealer
dealer_name	String	Simple Name
dept_uuid	String	ID of department
dealer_status	String	active / inactive
user_uuid	String	ID of SMS user
dealer_logo	String	URL to dealer logo
start_date	String	Date dealer switched to active
exclusion_list	String	Comma Separated String of Opcodes to exclude

Error Codes

HTTP Status Code	Description
400	Missing required fields (e.g., appointment_uuid).
401	Invalid or missing API key.
404	Appointment not found for the provided appointment_uuid.