# Aramisauto Vehicle API Documentation

Returns the full record for one car, addressed by the numeric id from a search result. The record carries price, mileage, technical data, emissions, delivery time, highlights, the equipment list (standard items and priced options), all photos and the Aramisauto expert comment. Fields Aramisauto does not provide are omitted. An unknown or sold id answers a 404 with error.code NOT_FOUND, which is not billable.

- **Documentation:** [https://scrappa.co/docs/aramisauto-api/aramisauto_vehicle](https://scrappa.co/docs/aramisauto-api/aramisauto_vehicle)
- **API group:** Aramisauto API
- **Endpoint:** `GET https://scrappa.co/api/aramisauto/vehicle`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `vehicle_id` | string | Yes | Numeric vehicle id from a search result, for example 1028391. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/aramisauto/vehicle?vehicle_id=1028391"
```

## Example response

```json
{
    "success": true,
    "data": {
        "vehicle": {
            "id": "1028391",
            "offer_id": "v352061",
            "url": "https://www.aramisauto.com/voitures/citroen/c3-aircross/plus/v352061?vehicleId=1028391",
            "offer_type": "0 km",
            "availability": "Disponible",
            "make": "Citro\u00ebn",
            "model": "C3 AIRCROSS",
            "model_iteration": "C3 Aircross",
            "engine": "Hybride 145 ch Aut",
            "trim": "Plus",
            "energy": "Mild Hybrid Essence",
            "transmission": "Automatique",
            "body": "4x4 et SUV",
            "color": "Gris",
            "first_registration_date": "2026-09-23",
            "price_eur": 21299,
            "catalog_price_eur": 27820,
            "discount_percent": 23.44,
            "mileage_km": 10,
            "power_hp": 136,
            "doors": 5,
            "seats": 5,
            "critair": "1",
            "delivery_days": 1,
            "highlights": [
                "Android Auto",
                "Apple CarPlay",
                "Bluetooth"
            ],
            "equipments": [
                {
                    "label": "Pr\u00e9disposition roue de secours",
                    "category": "Autre",
                    "type": "Option",
                    "price_eur": 20
                }
            ],
            "images": [
                "https://storage.googleapis.com/aramis_vehicles/production/betamodels/i_6abfa98ef1567.jpg"
            ],
            "updated_at": "2026-10-15T15:32:36Z"
        }
    },
    "meta": {
        "endpoint_family": "vehicle",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested vehicle was not found or is no longer listed. This response is not billable. |
| 422 | Validation Error | A parameter is invalid, including an unknown energy or sort, or page times limit above 10000. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Aramisauto. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)