{
  "opencollection": "1.0.0",
  "info": {
    "name": "Smartcar Vehicles API",
    "version": "2.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Connections",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Connections",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/connections"
          },
          "docs": "Returns all vehicle connections associated with the authorized user."
        },
        {
          "info": {
            "name": "Get Connection",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/connections/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Connection ID"
              }
            ]
          },
          "docs": "Retrieves a specific vehicle connection by connection ID."
        },
        {
          "info": {
            "name": "Remove Connection",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://vehicle.api.smartcar.com/v2.0/connections/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Connection ID"
              }
            ]
          },
          "docs": "Removes a vehicle connection, revoking access to that vehicle."
        },
        {
          "info": {
            "name": "Remove User",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://vehicle.api.smartcar.com/v2.0/users/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "User ID"
              }
            ]
          },
          "docs": "Removes all vehicle connections for a specific user."
        }
      ]
    },
    {
      "info": {
        "name": "Vehicle Data",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Vehicle",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Vehicle ID"
              }
            ]
          },
          "docs": "Retrieves attributes and metadata for a specific vehicle."
        },
        {
          "info": {
            "name": "Get Vehicle Signals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/signals",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Vehicle ID"
              }
            ]
          },
          "docs": "Reads all available signals (telemetry data) for a vehicle."
        },
        {
          "info": {
            "name": "Get Battery Level",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/battery",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the current battery level and estimated range for an electric or hybrid vehicle. Requires the read_battery permission."
        },
        {
          "info": {
            "name": "Get Location",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/location",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the current GPS coordinates of the vehicle. Requires the read_location permission."
        },
        {
          "info": {
            "name": "Get Odometer",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/odometer",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the vehicle's current odometer reading. Requires the read_odometer permission."
        },
        {
          "info": {
            "name": "Get Fuel Tank",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/fuel",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves fuel tank status including percentage remaining, amount remaining, and estimated range. Requires the read_fuel permission."
        },
        {
          "info": {
            "name": "Get Engine Oil Life",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/engine/oil",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the remaining engine oil life as a percentage. Requires the read_engine_oil permission."
        },
        {
          "info": {
            "name": "Get Diagnostic Trouble Codes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/diagnostics/dtcs",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves active diagnostic trouble codes (DTCs) from the vehicle's OBD-II system. Requires the read_diagnostics permission."
        },
        {
          "info": {
            "name": "Get Vehicle Permissions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/permissions",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Lists all permissions granted for the vehicle."
        },
        {
          "info": {
            "name": "Batch Vehicle Data Requests",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/batch",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Sends multiple data requests in a single API call and returns all responses together, reducing round-trips."
        }
      ]
    },
    {
      "info": {
        "name": "Charging",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Charge Status",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/charge",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the current charging status of an EV including plug-in state and charge progression. Requires the read_charge permission."
        },
        {
          "info": {
            "name": "Start Or Stop Charging",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/charge",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Starts or stops charging for an electric vehicle. Requires the control_charge permission."
        },
        {
          "info": {
            "name": "Get Charge Limit",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/charge/limit",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the current charge limit setting for an EV."
        },
        {
          "info": {
            "name": "Set Charge Limit",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/charge/limit",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Sets the maximum battery charge level (as a percentage) for an EV. Requires the control_charge permission."
        }
      ]
    },
    {
      "info": {
        "name": "Security",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Lock Status",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/security",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves the current lock/unlock status of the vehicle's doors, windows, storage, sunroof, and charge port. Requires the read_security permission."
        },
        {
          "info": {
            "name": "Lock Or Unlock Doors",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/security",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Locks or unlocks the vehicle's doors remotely. Requires the control_security permission."
        }
      ]
    },
    {
      "info": {
        "name": "Navigation",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Set Navigation Destination",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://vehicle.api.smartcar.com/v2.0/vehicles/:id/commands/set-destination",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Sets a navigation destination for the vehicle. Requires the control_navigation permission."
        }
      ]
    }
  ],
  "bundled": true
}