{"templateId":"markdown","versions":[{"version":"2.1-test","label":"2.1 (TEST)","link":"/products/liveidplus/2.1-test/enterprise/get-started/data-retrieval","default":false,"active":false,"folderId":"ed500da1"},{"version":"2.1","label":"2.1 (latest)","link":"/products/liveidplus/enterprise/get-started/data-retrieval","default":true,"active":true,"folderId":"ed500da1"},{"version":"2.0","label":"2.0","link":"/products/liveidplus/2.0/enterprise/get-started/data-retrieval","default":false,"active":false,"folderId":"ed500da1"}],"sharedDataIds":{"sidebar":"sidebar-products/liveidplus/@2.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Data Retrieval","description":"Integration and usage documentation.","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":"data-retrieval","__idx":0},"children":["Data Retrieval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a video identification call is completed, LiveID+ provides APIs to retrieve the call data, including photos, documents, form values, and the full audit trail."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-for-data-retrieval","__idx":1},"children":["Authentication for Data Retrieval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All data retrieval APIs require authentication. There are two methods:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token from call closing event"]},": The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message.token"]}," parameter included in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["close"]}," event payload can be used directly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API-generated token"]},": Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["genAPIToken"]}," endpoint to generate a token for a specific conference."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"generating-an-api-token","__idx":2},"children":["Generating an API Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/authenticate/genAPIToken"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," API Key (header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]},")"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$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":["idConference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique ID of the call"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"token\": \"jwt_token_string\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The generated token has a limited validity (approximately 2 minutes). Generate it immediately before using it to retrieve data."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieving-call-data","__idx":3},"children":["Retrieving Call Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/conferenceData"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Bearer token (header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]},")"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$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":["idConference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conference process ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["module"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specific module to retrieve: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"photo\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"formfilling\""]},". If omitted, all data is returned."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"call_answer_date\": \"2026-01-15T14:32:00.000Z\",\n  \"call_end_date\": \"2026-01-15T14:45:00.000Z\",\n  \"call_last_activity\": \"2026-01-15T14:44:50.000Z\",\n  \"end_pattern\": \"N\",\n  \"operator\": {\n    \"id\": \"operator-uuid\",\n    \"name\": \"Mario Rossi\",\n    \"external_id\": \"EXT-001\"\n  },\n  \"data\": {\n    \"module_1\": { ... },\n    \"module_2\": { ... }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_pattern"]}," values are:"]},{"$$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":"Value"},"children":["Value"]},{"$$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":["N"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Successfully completed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aborted by operator"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call closed by system"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Suspended"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For details about the module data structure, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/liveidplus/enterprise/get-started/conference-data-structure"},"children":["Conference Data Module Structure"]}," reference."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieving-audit-data-zip","__idx":4},"children":["Retrieving Audit Data (ZIP)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The audit data endpoint returns a ZIP file containing the audit log PDF, photos, and optionally video recordings from the identification session."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getauditdata-v2","__idx":5},"children":["getAuditData V2"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/getAuditData"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Bearer token (header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]},")"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$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":["idConference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conference process ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["av"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"1\""]}," to include audio/video recordings. Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"1\""]},", redirects directly to the ZIP file. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]},", returns a JSON with a presigned download URL. Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct=0"]},":"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"url\": \"https://s3-presigned-url-to-zip-file\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct=1"]},":"]}," HTTP 302 redirect to the ZIP file."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"zip-file-contents","__idx":6},"children":["ZIP File Contents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The downloaded ZIP archive contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Audit log PDF"]},": A structured document with the full trail of the identification session."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Photos"]},": All photos captured during the session (document scans, selfies, etc.)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Videos"]}," (if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["av=1"]},"): Organized as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/videos/operator/"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/videos/customer/"]}," subdirectories."]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deleting-audit-data","__idx":7},"children":["Deleting Audit Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /api/v2/deleteAuditData"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Bearer token (header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]},")"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$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":["idConference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conference process ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eraseAll"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"1\""]},", also erases database records. Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0\""]}," (only deletes physical files)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," By default, this endpoint deletes only the physical files (photos, videos, documents) while retaining audit metadata in the database. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eraseAll=1"]}," to permanently remove all data including database records."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rejecting-a-call","__idx":8},"children":["Rejecting a Call"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/v2/rejectCall"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," API Key (header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint allows an external system to programmatically reject a pending call."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"conference-uuid\",\n  \"note\": \"Rejection reason\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"callUpdated\": true\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Data Retrieval","id":"data-retrieval","depth":1},{"value":"Authentication for Data Retrieval","id":"authentication-for-data-retrieval","depth":2},{"value":"Generating an API Token","id":"generating-an-api-token","depth":3},{"value":"Retrieving Call Data","id":"retrieving-call-data","depth":2},{"value":"Retrieving Audit Data (ZIP)","id":"retrieving-audit-data-zip","depth":2},{"value":"getAuditData V2","id":"getauditdata-v2","depth":3},{"value":"ZIP File Contents","id":"zip-file-contents","depth":3},{"value":"Deleting Audit Data","id":"deleting-audit-data","depth":2},{"value":"Rejecting a Call","id":"rejecting-a-call","depth":2}],"frontmatter":{"outline":"deep","title":"Data Retrieval","scope":"vertical-solutions","product":"LiveID+","category":"get-started","version":"2.0","description":"Guide to retrieving call data, audit trails, photos, and videos from LiveID+ via REST APIs, including token generation and data deletion.","keywords":["data retrieval","audit data","conference data","call recording","REST API","LiveID+"],"seo":{"title":"Data Retrieval"}},"lastModified":"2026-07-16T07:59:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/liveidplus/enterprise/get-started/data-retrieval","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}