{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"meshVI API Quickstart","description":"meshVI (Mesh Verified Insurance) – InsurOps API for vehicle and driver insurance management. Verify COI, manage clients, drivers, policies, and certificates for fleets, motor carriers, and shippers.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"meshvi-api-quickstart","__idx":0},"children":["meshVI API Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-get-api-access","__idx":1},"children":["Step 1: Get API access"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact meshVI or your administrator to obtain API access, a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer token"]}," (JWT), and an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}," for the meshVI API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send the token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer …"]}," header and the API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," header on every request to the hosted API (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["Authentication"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-base-url","__idx":2},"children":["Step 2: Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this base URL for all requests:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Staging (UAT):"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://uat-verified.meshvi.com"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-verify-coi-for-a-client-first-request","__idx":3},"children":["Step 3: Verify COI for a client (first request)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify active certificates of insurance for one or more DOT numbers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"by-single-dot-number","__idx":4},"children":["By single DOT number"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://uat-verified.meshvi.com/v1/coverages/clients?dot=123456\" \\\\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\\\n  -H \"apiKey: YOUR_API_KEY\" \\\\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dot"]}]},": DOT number (digits only)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"by-client-id","__idx":5},"children":["By client ID"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://uat-verified.meshvi.com/v1/coverages/clients?id=1001\" \\\\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\\\n  -H \"apiKey: YOUR_API_KEY\" \\\\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-success","__idx":6},"children":["Example response (success)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes verification results per DOT/client, including client details and policy/coverage information when available."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-search-clients","__idx":7},"children":["Step 4: Search clients"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List clients with optional filters and pagination:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://uat-verified.meshvi.com/v1/clients?page=1&limit=20\" \\\\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\\\n  -H \"apiKey: YOUR_API_KEY\" \\\\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Optional query parameters: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dot"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agencyId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["producerId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]},", and others (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/meshvi"},"children":["API Reference"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-get-client-certificate","__idx":8},"children":["Step 5: Get client certificate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve the Acord certificate for a client by client ID or DOT (provide exactly one):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://uat-verified.meshvi.com/v1/certificates/clients?id=1001\" \\\\\n  -H \"Authorization: Bearer YOUR_API_TOKEN\" \\\\\n  -H \"apiKey: YOUR_API_KEY\" \\\\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":9},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["Authentication"]}," – Bearer token, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," header, and securing your requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/certificates"},"children":["Certificates and COI"]}," – Verify COI for clients and vehicles, and retrieve certificates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/meshvi"},"children":["API Reference"]}," – Full endpoint reference for clients, drivers, policies, and vehicles."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For product and support information, visit ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.meshvi.com"},"children":["meshvi.com"]},"."]}]},"headings":[{"value":"meshVI API Quickstart","id":"meshvi-api-quickstart","depth":1},{"value":"Step 1: Get API access","id":"step-1-get-api-access","depth":2},{"value":"Step 2: Base URL","id":"step-2-base-url","depth":2},{"value":"Step 3: Verify COI for a client (first request)","id":"step-3-verify-coi-for-a-client-first-request","depth":2},{"value":"By single DOT number","id":"by-single-dot-number","depth":3},{"value":"By client ID","id":"by-client-id","depth":3},{"value":"Example response (success)","id":"example-response-success","depth":3},{"value":"Step 4: Search clients","id":"step-4-search-clients","depth":2},{"value":"Step 5: Get client certificate","id":"step-5-get-client-certificate","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"meshVI API Quickstart"}},"lastModified":"2026-04-28T12:36:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}