> For the complete documentation index, see [llms.txt](https://docs.paveapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paveapi.com/integrations/developer-docs/sessions-1/retrieve-a-session-data.md).

# GET Session Data

```
https://openapi.paveapi.com/v1/sessions/:session_key
```

Replace **`:session_key`** with the unique **`session_key`** returned from your previous request, and PAVE will return the corresponding session information. information.

| Path Parameters   |        |                                                                |
| ----------------- | ------ | -------------------------------------------------------------- |
| **`session_key`** | string | Unique session\_key generated when the new session was created |

| Headers             |        |                                                    |
| ------------------- | ------ | -------------------------------------------------- |
| **`API-Key`**       | string | The API-Key that was provided for your account     |
| **`API-Token`**     | string | The API-Token used when the session was created    |
| **`API-Timestamp`** | string | UTC Datetime string, example: 2021-05-30T12:49:19Z |

#### **Sample** Response (**200: Ok)**

```
{
    "session_key": "XXX-ABCDE12345",
    "theme": "PRO",
    "active": true,
    "status": "COMPLETE",
    "redirect_url": "https://dev.paveinspect.com/valet/XXX-ABCDE12345/?l=en",
    "inspect_started_at": "2021-05-25T11:51:49.000000Z",
    "inspect_ended_at": "2021-05-25T11:56:05.000000Z",
    "created_at": "2021-05-25T11:50:49.000000Z",
    "updated_at": "2021-05-25T11:59:20.000000Z",
    "language": "EN",
    "options": {
        "client_id": "SOUTH234889",
        "sms": {
            "to": "647-455-XXXX",
            "to_name": "Jane Smith",
            "from": "647-422-XXXX",
            "by": "Steve's Test Dealer",
        }
    },
    "vehicle": {
            "vehicle_id": 19880,
            "vin": "5N1AT2MV0HCXXXXXX",
            "year": 2017,
            "make": "Nissan",
            "model": "Rogue",
            "body_type": "Wagon 4 Dr.",
            "trim": "AWD 4dr S *Ltd Avail*",
            "transmission": "AUTOMATIC",
            "drivetrain": "All Wheel Drive",
            "engine_type": "4 Cylinder Engine",
            "fuel_type": "Gasoline Fuel",
            "ext_col": "Glacier White",
            "int_col": "Black",
            "odom_reading": "100,945",
            "odom_unit": "KILOMETRES"
        }
}
```

#### **Sample Response** (**404: Not Found)**

Session not successfully retrieved

```
{
    "message": "Session :session_key cannot be found."
}
```

#### Vehicle Object

| Attribute          | Type    | Description                                                        |
| ------------------ | ------- | ------------------------------------------------------------------ |
| **`vehicle_id`**   | integer | PAVE system ID for vehicle                                         |
| **`vin`**          | string  | The VIN inputted or extracted for the session                      |
| **`year`**         | integer | The Year of the vehicle                                            |
| **`make`**         | string  | The Make of the vehicle                                            |
| **`model`**        | string  | The Model of the vehicle                                           |
| **`body_type`**    | string  | The vehicle's body type                                            |
| **`trim`**         | string  | The Trim detected of the vehicle                                   |
| **`transmission`** | string  | The Transmission detected for the vehicle                          |
| **`drivetrain`**   | string  | The Drivetrain of the vehicle                                      |
| **`engine_type`**  | string  | The Engine Type of the vehicle                                     |
| **`fuel_type`**    | string  | The Fuel Type of the vehicle                                       |
| **`ext_col`**      | string  | The Exterior Color detected of the vehicle                         |
| **`int_col`**      | string  | The Interior Color detected of the vehicle                         |
| **`odom_reading`** | integer | The Odometer Reading inputted or extracted for the session         |
| **`odom_unit`**    | string  | The Odometer unit of measure inputted or extracted for the session |

Vehicle data may not appear if the User has not yet captured their VIN and no VIN look-up information is found.