# meshVI API Quickstart

This guide helps you make your first authenticated call to the meshVI API—for example, verifying a certificate of insurance (COI) for a client by DOT number.

## Step 1: Get API access

1. Contact meshVI or your administrator to obtain API access, a **Bearer token** (JWT), and an **API key** for the meshVI API.
2. Send the token in the `Authorization: Bearer …` header and the API key in the `apiKey` header on every request to the hosted API (see [Authentication](/guides/authentication)).


## Step 2: Base URL

Use this base URL for all requests:

- **Staging (UAT):** `https://uat-verified.meshvi.com`


## Step 3: Verify COI for a client (first request)

Verify active certificates of insurance for one or more DOT numbers.

### By single DOT number


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

- **`dot`**: DOT number (digits only).


### By client ID


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

### Example response (success)

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

## Step 4: Search clients

List clients with optional filters and pagination:


```bash
curl -X GET "https://uat-verified.meshvi.com/v1/clients?page=1&limit=20" \\
  -H "Authorization: Bearer YOUR_API_TOKEN" \\
  -H "apiKey: YOUR_API_KEY" \\
  -H "Accept: application/json"
```

Optional query parameters: `name`, `dot`, `agencyId`, `producerId`, `sort`, and others (see [API Reference](/apis/meshvi)).

## Step 5: Get client certificate

Retrieve the Acord certificate for a client by client ID or DOT (provide exactly one):


```bash
curl -X GET "https://uat-verified.meshvi.com/v1/certificates/clients?id=1001" \\
  -H "Authorization: Bearer YOUR_API_TOKEN" \\
  -H "apiKey: YOUR_API_KEY" \\
  -H "Accept: application/json"
```

## Next steps

- [Authentication](/guides/authentication) – Bearer token, `apiKey` header, and securing your requests.
- [Certificates and COI](/guides/certificates) – Verify COI for clients and vehicles, and retrieve certificates.
- [API Reference](/apis/meshvi) – Full endpoint reference for clients, drivers, policies, and vehicles.


For product and support information, visit [meshvi.com](https://www.meshvi.com).