# Certificates and COI verification

meshVI supports verification of **Certificates of Insurance (COI)** and retrieval of **Acord** certificates for clients and vehicles.

## Verify COI for clients

**Endpoint:** `GET /v1/coverages/clients`

Verify active insurance coverage by DOT number or client ID. Provide **exactly one** of:

- **`dots`** – Array of DOT numbers (e.g. `dots=123456&dots=789012`).
- **`dot`** – Single DOT number (digits only).
- **`id`** – Client ID.


### Example: by DOT number

```bash
curl -X GET "https://uat-verified.meshvi.com/v1/coverages/clients?dot=123456" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "apiKey: YOUR_API_KEY" \\
  -H "Accept: application/json"
```

The response includes verification results per DOT, with client and policy/coverage details when available.

## Verify COI for vehicles

**Endpoint:** `GET /v1/coverages/vehicles`

Verify certificate of insurance for a vehicle. Provide **exactly one** of:

- **`vin`** – 17-character VIN.
- **`licensePlate`** – License plate number.


### Example: by VIN

```bash
curl -X GET "https://uat-verified.meshvi.com/v1/coverages/vehicles?vin=1HGBH41JXMN109186" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "apiKey: YOUR_API_KEY" \\
  -H "Accept: application/json"
```

## Get client certificate

**Endpoint:** `GET /v1/certificates/clients`

Retrieve the Acord certificate for a client. Provide **exactly one** of:

- **`id`** – Client ID.
- **`dot`** – DOT number (digits only).


## Get vehicle certificate

**Endpoint:** `GET /v1/certificates/vehicles`

Retrieve the Acord certificate for a vehicle. Provide **exactly one** of:

- **`id`** – Vehicle ID.
- **`vin`** – 17-character VIN.
- **`licensePlate`** – License plate number.


Optional **`clientId`** can be used for context where applicable.

## Error handling

- **400** – Invalid or missing parameters (e.g. both `vin` and `licensePlate` provided, or neither).
- **401** – Missing or invalid credentials (Bearer token or `apiKey` header).
- **404** – DOT or resource not found (e.g. DOT number not found in verification response).


See the [API Reference](/apis/meshvi) for full request/response schemas.