# MeshVI API

API documentation for MeshVI services. These endpoints require API authorization ([APIAuthorize]) via Bearer token. Includes Acord certificate verification and retrieval, client, driver, policy, and vehicle operations for real-time insurance verification and fleet management.

Version: 1.0.0

## Servers

Production
```
https://verified.meshvi.com
```

## Security

### BearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[MeshVI API](https://meshviapi.redocly.app/_bundle/apis/meshvi.yaml)

## Certificates

Certificate verification and retrieval (Acord).

### Get client certificate

 - [GET /v1/certificates/clients](https://meshviapi.redocly.app/apis/meshvi/certificates/paths/~1v1~1certificates~1clients/get.md): Retrieves the Acord certificate for a client. Provide either client id or DOT number (exactly one).

### Verify COI for clients

 - [GET /v1/coverages/clients](https://meshviapi.redocly.app/apis/meshvi/certificates/paths/~1v1~1coverages~1clients/get.md): Verifies active certificates of insurance across DOT numbers. Provide exactly one of: dots (array), dot (single), or id (client ID).

### Verify vehicle COI

 - [GET /v1/coverages/vehicles](https://meshviapi.redocly.app/apis/meshvi/certificates/paths/~1v1~1coverages~1vehicles/get.md): Verifies certificate of insurance for a vehicle. Provide either vin or licensePlate (exactly one).

### Get vehicle certificate

 - [GET /v1/certificates/vehicles](https://meshviapi.redocly.app/apis/meshvi/certificates/paths/~1v1~1certificates~1vehicles/get.md): Retrieves the Acord certificate for a vehicle. Provide exactly one of: id, vin, or licensePlate. clientId may be used in some contexts.

### Get vehicle certificate

 - [GET /v1/certificates/vehicles](https://meshviapi.redocly.app/apis/meshvi/vehicles/paths/~1v1~1certificates~1vehicles/get.md): Retrieves the Acord certificate for a vehicle. Provide exactly one of: id, vin, or licensePlate. clientId may be used in some contexts.

## Vehicles

Vehicle certificate operations.

### Get vehicle certificate

 - [GET /v1/certificates/vehicles](https://meshviapi.redocly.app/apis/meshvi/certificates/paths/~1v1~1certificates~1vehicles/get.md): Retrieves the Acord certificate for a vehicle. Provide exactly one of: id, vin, or licensePlate. clientId may be used in some contexts.

### Get vehicle certificate

 - [GET /v1/certificates/vehicles](https://meshviapi.redocly.app/apis/meshvi/vehicles/paths/~1v1~1certificates~1vehicles/get.md): Retrieves the Acord certificate for a vehicle. Provide exactly one of: id, vin, or licensePlate. clientId may be used in some contexts.

## Clients

Client CRUD and search.

### Search clients

 - [GET /v1/clients](https://meshviapi.redocly.app/apis/meshvi/clients/paths/~1v1~1clients/get.md): Paginated search of clients with filtering and sorting. Supports page, limit, sort, and filters (name, dot, agencyId, producerId, parentClientId, deleted, clientTypeId, acordEnabled).

### Create client

 - [POST /v1/clients](https://meshviapi.redocly.app/apis/meshvi/clients/paths/~1v1~1clients/post.md): Creates a new client. Required: clientName, agencyId. Optional: producerId and other client fields.

### Get client detail

 - [GET /v1/clients/{id}](https://meshviapi.redocly.app/apis/meshvi/clients/paths/~1v1~1clients~1%7Bid%7D/get.md): Retrieves client details by ID.

### Update client

 - [PUT /v1/clients/{id}](https://meshviapi.redocly.app/apis/meshvi/clients/paths/~1v1~1clients~1%7Bid%7D/put.md): Updates an existing client. Only provided fields are updated.

## Drivers

Driver search and list.

### Search drivers

 - [POST /v1/drivers/search](https://meshviapi.redocly.app/apis/meshvi/drivers/paths/~1v1~1drivers~1search/post.md): Returns a paginated list of drivers based on filter and paging request.

## Policies

Policy CRUD and search.

### Search policies

 - [GET /v1/policies](https://meshviapi.redocly.app/apis/meshvi/policies/paths/~1v1~1policies/get.md): Paginated search of policies. Query params: page, limit, sort, q, policy, clientId, deleted, status, coverageType.

### Create policy

 - [POST /v1/policies](https://meshviapi.redocly.app/apis/meshvi/policies/paths/~1v1~1policies/post.md): Creates a new policy. Required: clientId, coverageType, effectiveDate, expirationDate.

### Get policy detail

 - [GET /v1/policies/{id}](https://meshviapi.redocly.app/apis/meshvi/policies/paths/~1v1~1policies~1%7Bid%7D/get.md): Retrieves policy details by ID.

### Get policy list

 - [POST /v1/policies/search](https://meshviapi.redocly.app/apis/meshvi/policies/paths/~1v1~1policies~1search/post.md): Returns a paginated list of policies based on filter and paging request (body).