{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en-US/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Certificate","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":"certificate","__idx":0},"children":["Certificate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The VirtualCar360 vehicle certificate can be accessed independently of the Player through a dedicated Certificate API. The endpoint returns certificate links in several formats:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["widget"]}," that can be embedded in an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["onepage"]}," certificate view,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["downloadable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PDF"]}," files in available languages."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Certificates can also be visible directly in the Player if they are available for a given vehicle. The Certificate API is intended for integrations that need to display or share the certificate outside the Player, for example on a vehicle page, in CRM, DMS or an administrative panel."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Information"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you use the Player, the certificate can be displayed directly in the Player interface. The Certificate API provides an extended, independent way to retrieve and embed the certificate."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"access","__idx":1},"children":["Access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The endpoint requires an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]},". The key can be issued by VirtualCar360 support for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a single location,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the entire organization,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a group of locations or dealers."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The returned data depends on the permissions assigned to the key."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://api-certificate.vc360.app/api/v1/{apiKey}/certificate/vin/{vin}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://api-certificate.vc360.app/api/v1/a0d8eb5cd984c08a58e7b88a/certificate/vin/WVWZZZ3H5RE500898\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-example","__idx":3},"children":["Response example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"widget\": \"https://certificate.vc360.app/widget/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\",\n  \"onepage\": \"https://certificate.vc360.app/certificate/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\",\n  \"pdf\": [\n    {\n      \"language\": \"pl\",\n      \"code\": \"pia-pdf\",\n      \"fileUrl\": \"https://vc360inspectionstorage.blob.core.windows.net/inspectiondata/2025/pdf/example/example-pia-pdf-pl.pdf?...\"\n    },\n    {\n      \"language\": \"en\",\n      \"code\": \"pia-pdf\",\n      \"fileUrl\": \"https://vc360inspectionstorage.blob.core.windows.net/inspectiondata/2025/pdf/example/example-pia-pdf-en.pdf?...\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-fields","__idx":4},"children":["Response fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL to the widget certificate view. Best for embedding in an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL to the full certificate page. Can be opened directly or embedded in an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List of available PDF certificate files."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].language"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF language code, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF document type code, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pia-pdf"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf[].fileUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL to the PDF file. The URL may be temporary."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"embedding-the-widget","__idx":5},"children":["Embedding the widget"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<div class=\"certificate-widget-wrapper\">\n  <iframe\n    src=\"https://certificate.vc360.app/widget/inspection-pia/1f093ac5-dd71-6f24-8abc-c735770b85d5/pl\"\n    title=\"VirtualCar360 vehicle certificate\"\n    frameborder=\"0\"\n    allowfullscreen\n  ></iframe>\n</div>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"css","header":{"controls":{"copy":{}}},"source":".certificate-widget-wrapper {\n  width: 100%;\n  min-height: 720px;\n}\n\n.certificate-widget-wrapper iframe {\n  width: 100%;\n  height: 720px;\n  border: 0;\n}\n","lang":"css"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"onepage-and-pdf","__idx":6},"children":["Onepage and PDF"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}," URL can be used as a link or embedded in an iframe. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}," array contains available PDF files in different languages."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Languages"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Widget, onepage and PDF versions can be available in multiple languages. Available languages depend on certificate configuration and the API response."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"certificate-in-the-player-vs-certificate-api","__idx":7},"children":["Certificate in the Player vs Certificate API"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scenario"},"children":["Scenario"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Recommended solution"},"children":["Recommended solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate as part of a ready-made vehicle presentation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Player"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate embedded in a separate page section"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate as a standalone page"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate for download or sending to a customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate in CRM or DMS"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificate API"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":8},"children":["Best practices"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fetch certificates through the customer's backend to avoid exposing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget"]}," for embedded website views."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onepage"]}," for opening the certificate as a separate page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}," for downloadable documents."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handle multiple language versions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not assume that every vehicle has a certificate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not store temporary PDF URLs as permanent links."]}]}]},"headings":[{"value":"Certificate","id":"certificate","depth":1},{"value":"Access","id":"access","depth":2},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Response example","id":"response-example","depth":2},{"value":"Response fields","id":"response-fields","depth":2},{"value":"Embedding the widget","id":"embedding-the-widget","depth":2},{"value":"Onepage and PDF","id":"onepage-and-pdf","depth":2},{"value":"Certificate in the Player vs Certificate API","id":"certificate-in-the-player-vs-certificate-api","depth":2},{"value":"Best practices","id":"best-practices","depth":2}],"frontmatter":{"seo":{"title":"Certificate"}},"lastModified":"2026-06-16T21:52:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en-us/certificate","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}