Skip to content
Last updated

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).

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

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

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:

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).

Step 5: Get client certificate

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

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 – Bearer token, apiKey header, and securing your requests.
  • Certificates and COI – Verify COI for clients and vehicles, and retrieve certificates.
  • API Reference – Full endpoint reference for clients, drivers, policies, and vehicles.

For product and support information, visit meshvi.com.

Use Cases