Certificates and COI verification

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

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.

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.

Endpoint: GET /v1/coverages/vehicles

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

• vin – 17-character VIN.
• licensePlate – License plate number.

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"

Endpoint: GET /v1/certificates/clients

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

• id – Client ID.
• dot – DOT number (digits only).

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.

• 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 for full request/response schemas.