> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fleeticc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List vehicles

> Get the vehicles linked to your Partner API account

Get vehicles for the account tied to your API key. Use this to map Fleeticc `vehicleId` / `imei` into your system.

## Request

**X-Api-Key** `string` *required*

Your Partner API key (`pk_…`)

**X-Timestamp** `string` *required*

Current Unix time in seconds

**X-Signature** `string` *required*

HMAC-SHA256 hex signature — see [Authentication](https://docs.fleeticc.com/api-reference/endpoint/authentication.md)

No query parameters.

## Request example

```bash theme={null}
export PATH="/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin:$PATH"
KEY="$FLEETICC_API_KEY"
SECRET="$FLEETICC_API_SECRET"
REQ_PATH="/api/partner/v1/vehicles"
TS=$(date +%s)
BODY_HASH=$(printf '' | openssl dgst -sha256 -hex | awk '{print $NF}')
SIG=$(printf 'GET\n%s\n%s\n%s' "$REQ_PATH" "$TS" "$BODY_HASH" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $NF}')

curl -sS -X GET "https://api.fleeticc.com$REQ_PATH" \
  -H "X-Api-Key: $KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"
```

## Response

**code** `string`

`"200"` on success

**message** `string`

Human-readable status

**data.vehicles** `array`

Vehicle list

**vehicle fields**

**vehicleId** `string`

Fleeticc vehicle UUID (best value to store)

**imei** `string`

GPS device id

**plateNumber** `string`

Number plate

**vehicleName** `string`

Display name

```json theme={null}
{
  "code": "200",
  "message": "Partner vehicles listed successfully.",
  "data": {
    "vehicles": [
      {
        "vehicleId": "8f3c2a1b-4d5e-6f70-8192-a3b4c5d6e7f8",
        "imei": "359633100000001",
        "plateNumber": "ABC-1234",
        "vehicleName": "Truck 01"
      }
    ]
  }
}
```

## Limits

Up to **60** requests per minute per API key.


## OpenAPI

````yaml GET /api/partner/v1/vehicles
openapi: 3.1.0
info:
  title: Fleeticc Partner API
  description: >-
    Live and historical GPS for partner backends. HMAC-SHA256 auth. Base:
    https://api.fleeticc.com
  version: 1.0.0
  contact:
    email: info@fleeticc.com
    url: https://fleeticc.com/contact
servers:
  - url: https://api.fleeticc.com
    description: Production
security:
  - PartnerHmac: []
paths:
  /api/partner/v1/vehicles:
    get:
      summary: List vehicles
      description: Vehicles linked to the Partner API account.
      operationId: partnerListVehicles
      parameters:
        - $ref: '#/components/parameters/XApiKey'
        - $ref: '#/components/parameters/XTimestamp'
        - $ref: '#/components/parameters/XSignature'
      responses:
        '200':
          description: Owner vehicles
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiSuccess'
              example:
                code: '200'
                message: Partner vehicles listed successfully.
                data:
                  vehicles:
                    - vehicleId: 8f3c2a1b-4d5e-6f70-8192-a3b4c5d6e7f8
                      imei: '359633100000001'
                      plateNumber: ABC-1234
                      vehicleName: Truck 01
        '401':
          description: Auth failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  parameters:
    XApiKey:
      name: X-Api-Key
      in: header
      required: true
      schema:
        type: string
        example: pk_078dd6a8b290dbce3543d18f9c6cf72d
      description: Your Partner API key
    XTimestamp:
      name: X-Timestamp
      in: header
      required: true
      schema:
        type: string
        example: '1761200000'
      description: Current Unix time in seconds (±5 minutes)
    XSignature:
      name: X-Signature
      in: header
      required: true
      schema:
        type: string
      description: HMAC-SHA256 hex of METHOD\nPATH\nTIMESTAMP\nBODY_SHA256
  schemas:
    ApiSuccess:
      type: object
      properties:
        code:
          type: string
          example: '200'
        message:
          type: string
        data:
          type: object
    ApiError:
      type: object
      properties:
        code:
          type: string
          example: '401'
        message:
          type: string
        data:
          nullable: true
        error:
          type: string
          example: PARTNER_AUTH_INVALID
  securitySchemes:
    PartnerHmac:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Also send X-Timestamp (Unix seconds) and X-Signature (HMAC-SHA256 hex).
        See Authentication.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.