{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Authentication","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":"authentication","__idx":0},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All meshVI API endpoints described in this documentation require ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API authorization"]}," via a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer token"]}," (JWT) and an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}," in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}]}," HTTP header."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer"]}," token is validated by the meshVI API application (including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[APIAuthorize]"]}," routes). The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}]}," header is required at the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["hosted API edge"]}," (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://uat-verified.meshvi.com"]},") in addition to the token."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bearer-token","__idx":1},"children":["Bearer token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include your token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header of every request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer YOUR_ACCESS_TOKEN\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-key","__idx":2},"children":["API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include your API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}," header on every request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"apiKey: YOUR_API_KEY\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":3},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Staging is the environment documented here (see the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Servers"]}," list in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/meshvi"},"children":["API Reference"]},"):"]},{"$$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":3,"id":"example","__idx":4},"children":["Example"]},{"$$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=10\" \\\\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\\\n  -H \"apiKey: YOUR_API_KEY\" \\\\\n  -H \"Accept: application/json\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtaining-credentials","__idx":5},"children":["Obtaining credentials"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API access, tokens, and API keys are provided through meshVI or your organization’s administrator."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For integration and token requests, contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.meshvi.com"},"children":["meshVI"]}," or use your existing meshVI portal/account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security","__idx":6},"children":["Security"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not share or commit tokens or API keys in source code or public repositories."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use environment variables or a secure secrets manager in your application."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treat tokens and keys as sensitive credentials; rotate them if exposure is suspected."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"unauthorized-401","__idx":7},"children":["Unauthorized (401)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the token or API key is missing, invalid, or expired, the API returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]},". Ensure both headers are set correctly and the credentials are valid."]}]},"headings":[{"value":"Authentication","id":"authentication","depth":1},{"value":"Bearer token","id":"bearer-token","depth":2},{"value":"API key","id":"api-key","depth":2},{"value":"Base URL","id":"base-url","depth":2},{"value":"Example","id":"example","depth":3},{"value":"Obtaining credentials","id":"obtaining-credentials","depth":2},{"value":"Security","id":"security","depth":2},{"value":"Unauthorized (401)","id":"unauthorized-401","depth":2}],"frontmatter":{"seo":{"title":"Authentication"}},"lastModified":"2026-04-28T12:36:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}