{"openapi":"3.1.0","info":{"title":"Zavia Ownership API","version":"1.0.3","description":"Company resolution, paid ownership investigations and saved evidence, sourced through the Global Database KYB API. Zavia adds account access, orchestration, saved reports and derived display fields. This is an ownership API, not a proxy for the entire upstream catalogue. Financials, contacts, sanctions/PEP screening, standalone registry-document downloads, and monitoring management are not exposed here. REST, MCP and the dashboard share workspace report credit. Free company previews are separate from paid ownership reports. One data request per second per workspace. JSON request bodies are limited to 16 KiB for REST and 32 KiB for MCP. New response fields may be added; ignore fields your client does not use."},"servers":[{"url":"https://zavia-api.buldumak.workers.dev/api/v1"}],"security":[{"ZaviaKey":[]}],"paths":{"/search":{"post":{"summary":"Search companies","operationId":"searchCompanies","security":[{"ZaviaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchInput"},"examples":{"illustrative":{"summary":"Fictional input; replace with your company and country","value":{"identifier":"EXAMPLE LIMITED","country":"GB"}}}}}},"responses":{"200":{"description":"Successful result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"},"examples":{"matchedCompany":{"summary":"Fictional company match; confirm the exact entity before investigating","value":{"status":"ok","requestId":"bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb","query":{"identifier":"EXAMPLE LIMITED","country":"GB","subdivision":""},"candidates":[{"id":"123456","name":"EXAMPLE LIMITED","countryCode":"GB","status":"Active","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}}],"selectionRequired":true,"searchComplete":true,"warnings":[]}},"noMatches":{"summary":"Completed search with no matches","value":{"status":"ok","requestId":"bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb","query":{"identifier":"Example company","country":"GB","subdivision":""},"candidates":[],"selectionRequired":false,"searchComplete":true,"warnings":[]}}}}}},"400":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedJson":{"summary":"Malformed JSON","value":{"error":{"code":"invalid_request","message":"Send a valid JSON object."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"401":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidKey":{"summary":"Missing, expired or revoked key","value":{"error":{"code":"invalid_api_key","message":"The API key is invalid, expired or revoked."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"402":{"description":"Paid report credit is required; do not retry without adding credit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"reportCredit":{"summary":"Paid report credit required","value":{"error":{"code":"report_purchase_required","message":"Paid report credit is required."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"403":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"readOnlyKey":{"summary":"Full access required","value":{"error":{"code":"insufficient_scope","message":"This key is read-only. Use a full-access key to start or resume investigations."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"404":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"caseNotFound":{"summary":"Case unavailable in this workspace","value":{"error":{"code":"case_not_found","message":"Investigation not found in this workspace."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"409":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"inputChanged":{"summary":"Same run ID with different inputs","value":{"error":{"code":"run_input_changed","message":"This request belongs to different search or ownership settings. Start a new investigation."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"inProgress":{"summary":"Concurrent request for the same run","value":{"error":{"code":"run_in_progress","message":"The investigation is already running. Retry the same run ID."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"terminalFailure":{"summary":"Failed run; original reservation released","value":{"error":{"code":"run_failed","message":"The previous attempt ended and its check was released. Start the investigation again."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"410":{"description":"The upstream investigation job expired; start a new run with a new UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"expiredJob":{"summary":"Upstream job expired","value":{"error":{"code":"ubo_job_expired","message":"The upstream investigation job has expired."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"413":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"bodyTooLarge":{"summary":"JSON body exceeds the limit","value":{"error":{"code":"request_too_large","message":"The request body is too large."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"415":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"contentType":{"summary":"Content type must be application/json","value":{"error":{"code":"unsupported_media_type","message":"Send application/json."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"422":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidFields":{"summary":"Request validation failed","value":{"error":{"code":"invalid_request","message":"country: Invalid"},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"429":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rateLimit":{"summary":"Retry after the Retry-After header delay","value":{"error":{"code":"rate_limited","message":"One data request per second per workspace, shared across API keys and MCP. Retry after one second."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"searchAllowance":{"summary":"Daily API search allowance exhausted","value":{"error":{"code":"search_limit_reached","message":"The daily API search allowance has been reached."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for the per-workspace rate limit; delay in seconds."}}},"503":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"temporarilyUnavailable":{"summary":"Service temporarily unavailable","value":{"error":{"code":"temporarily_unavailable","message":"The API request could not complete. Retry shortly."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}}}}},"/investigations":{"post":{"summary":"Start, resume or cancel an ownership investigation","operationId":"investigateCompany","security":[{"ZaviaKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigationInput"},"examples":{"start":{"summary":"Start once; replace the fictional company ID and generate your own UUID","value":{"identifier":"EXAMPLE LIMITED","country":"GB","selectedCompanyId":"123456","runId":"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa","threshold":25,"maxDepth":10,"purpose":"ownership"}},"resume":{"summary":"Reuse the original inputs and run ID after HTTP 202","value":{"identifier":"EXAMPLE LIMITED","country":"GB","selectedCompanyId":"123456","runId":"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa","threshold":25,"maxDepth":10,"purpose":"ownership","resume":true}},"cancel":{"summary":"Cancel an unfinished run using its original inputs","value":{"identifier":"EXAMPLE LIMITED","country":"GB","selectedCompanyId":"123456","runId":"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa","threshold":25,"maxDepth":10,"purpose":"ownership","cancel":true}}}}}},"responses":{"200":{"description":"Saved report, or status cancelled for a cancelled unfinished run.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/InvestigationResult"},{"type":"object","required":["status"],"properties":{"status":{"const":"cancelled"}}}]},"examples":{"savedReport":{"summary":"Complete fictional JSON response with usable partial ownership evidence","value":{"status":"ok","subject":{"id":"123456","name":"EXAMPLE LIMITED","countryCode":"GB","status":"Active","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}},"query":{"identifier":"EXAMPLE LIMITED","country":"GB","subdivision":""},"ubo":{"company":{"id":"123456","name":"EXAMPLE LIMITED","country_code":"GB","status":"Active"},"summary":{"as_of":"2026-11-08","threshold":25,"max_depth":10,"max_depth_reached":1,"total_ubos":1,"determination":"partial","chain_complete":false,"ubo_determination_conclusive":false,"percentages_are_minimum":true,"risk_flags":[],"data_warnings":["Ownership beyond Example Holdings is unavailable."],"ownership_breakdown":{"ubo_percentage":70,"below_threshold_person_percentage":0,"listed_entity_percentage":0,"unresolved_entity_percentage":30,"untraced_percentage":0,"total_percentage":100},"enrichment":{"mode":"internal","status":"not_requested","units_consumed":0}},"data":[{"id":"example-person","full_name":"Alex Example","first_name":"Alex","last_name":"Example","nationality":null,"date_of_birth":null,"address":null,"status":null,"ceased_on":null,"notified_on":null,"country_of_residence":null,"is_pep":null,"control_types":["ownership"],"ownership":{"direct_percentage":70,"indirect_percentage":0,"effective_percentage":70,"voting_percentage":null,"has_direct_ownership":true,"has_indirect_ownership":false},"paths_total":1,"paths_truncated":false,"paths":[{"type":"direct","depth":1,"path_percentage":70,"nodes":[{"name":"EXAMPLE LIMITED","type":"company","level":0,"entity_id":"123456","country_code":"GB"},{"name":"Alex Example","type":"person","level":1,"entity_id":"example-person","percentage":70,"percentage_derived":false}]}],"provenance":{"source":null,"source_type":null,"determination_type":"calculated","retrieved_at":"2026-11-08T08:00:00Z"}}],"terminal_entities":[{"entity_id":"654321","name":"EXAMPLE HOLDINGS","type":"company","country_code":"GB","effective_percentage":30,"reason":"Ownership information unavailable","path":[{"name":"EXAMPLE LIMITED","type":"company","level":0,"entity_id":"123456","country_code":"GB"},{"name":"EXAMPLE HOLDINGS","type":"company","level":1,"entity_id":"654321","country_code":"GB","percentage":30,"percentage_derived":false}]}],"total_results":1,"total_pages":1},"summary":{"directShareholderCount":2,"currentPercentageTotal":100,"shareholderSetComplete":true,"ownershipChainComplete":false,"ownershipPathCount":1,"corporateBranchCount":1},"shareholders":[{"id":"example-person","name":"Alex Example","type":"person","percentage":70,"status":"current","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"eligibleForOwnershipCalculation":true,"identityEligibleForAutomation":false,"issueCodes":["source_unavailable"]},{"id":"654321","name":"EXAMPLE HOLDINGS","type":"company","percentage":30,"status":"current","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"linkedCompanyId":"654321","eligibleForOwnershipCalculation":true,"identityEligibleForAutomation":false,"issueCodes":["source_unavailable"]}],"officers":{"status":"unavailable","checkedAt":"2026-11-08T08:00:00Z","candidates":[],"excludedCount":0,"message":"Officer evidence was unavailable in this fictional example."},"ownershipPaths":[{"personName":"Alex Example","identityBasis":"provider_person_id","effectivePercentage":70,"provisional":true,"path":[{"companyId":"123456","companyName":"EXAMPLE LIMITED","companyCountryCode":"GB","holderName":"Alex Example","holderType":"person","edgePercentage":70,"effectivePercentage":70,"source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[]}]}],"ultimateBeneficialOwners":[{"personName":"Alex Example","identityBasis":"provider_person_id","effectivePercentage":70,"exceedsThreshold":true,"pathCount":1,"source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}}],"corporateBranches":[{"holderName":"EXAMPLE HOLDINGS","directPercentage":30,"effectivePercentage":30,"ownershipSource":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"status":"unavailable","issueCodes":["ownership_unavailable"],"path":["EXAMPLE LIMITED","EXAMPLE HOLDINGS"]}],"group":{"status":"not_found","usedForOwnershipCalculation":false,"path":[],"nodes":[]},"calculation":{"thresholdPercentage":25,"denominatorTolerance":0.5,"provenance":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}},"retrievalTrace":[],"warnings":["Fictional example. Source provenance and part of the ownership chain are unavailable."],"unresolvedGaps":["Unresolved corporate ownership: 30%","Source provenance is unavailable."],"determinationOutcome":"incomplete","billing":{"units":1,"reason":"ownership_evidence","message":"Usable partial ownership evidence was returned."},"isSample":false,"previewOnly":false,"generatedAt":"2026-11-08T08:00:00Z","requestId":"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee","caseId":"dddddddd-dddd-4ddd-8ddd-dddddddddddd"}},"cancelled":{"summary":"Unfinished run cancelled","value":{"status":"cancelled"}}}}}},"202":{"description":"Processing. Wait retryAfterSeconds and resend the same inputs with resume:true.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Processing"},"examples":{"illustrative":{"summary":"Investigation still processing; poll with the same run ID","value":{"status":"processing","runId":"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa","retryAfterSeconds":3,"progress":{"entitiesResolved":2,"entitiesPending":1,"currentDepth":2},"message":"Calculating ownership. The completed report will be saved to your workspace."}}}}}},"400":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedJson":{"summary":"Malformed JSON","value":{"error":{"code":"invalid_request","message":"Send a valid JSON object."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"401":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidKey":{"summary":"Missing, expired or revoked key","value":{"error":{"code":"invalid_api_key","message":"The API key is invalid, expired or revoked."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"402":{"description":"Paid report credit is required; do not retry without adding credit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"reportCredit":{"summary":"Paid report credit required","value":{"error":{"code":"report_purchase_required","message":"Paid report credit is required."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"403":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"readOnlyKey":{"summary":"Full access required","value":{"error":{"code":"insufficient_scope","message":"This key is read-only. Use a full-access key to start or resume investigations."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"404":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"caseNotFound":{"summary":"Case unavailable in this workspace","value":{"error":{"code":"case_not_found","message":"Investigation not found in this workspace."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"409":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"inputChanged":{"summary":"Same run ID with different inputs","value":{"error":{"code":"run_input_changed","message":"This request belongs to different search or ownership settings. Start a new investigation."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"inProgress":{"summary":"Concurrent request for the same run","value":{"error":{"code":"run_in_progress","message":"The investigation is already running. Retry the same run ID."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"terminalFailure":{"summary":"Failed run; original reservation released","value":{"error":{"code":"run_failed","message":"The previous attempt ended and its check was released. Start the investigation again."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"410":{"description":"The upstream investigation job expired; start a new run with a new UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"expiredJob":{"summary":"Upstream job expired","value":{"error":{"code":"ubo_job_expired","message":"The upstream investigation job has expired."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"413":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"bodyTooLarge":{"summary":"JSON body exceeds the limit","value":{"error":{"code":"request_too_large","message":"The request body is too large."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"415":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"contentType":{"summary":"Content type must be application/json","value":{"error":{"code":"unsupported_media_type","message":"Send application/json."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"422":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidFields":{"summary":"Request validation failed","value":{"error":{"code":"invalid_request","message":"country: Invalid"},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"429":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rateLimit":{"summary":"Retry after the Retry-After header delay","value":{"error":{"code":"rate_limited","message":"One data request per second per workspace, shared across API keys and MCP. Retry after one second."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"searchAllowance":{"summary":"Daily API search allowance exhausted","value":{"error":{"code":"search_limit_reached","message":"The daily API search allowance has been reached."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for the per-workspace rate limit; delay in seconds."}}},"503":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"temporarilyUnavailable":{"summary":"Service temporarily unavailable","value":{"error":{"code":"temporarily_unavailable","message":"The API request could not complete. Retry shortly."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}}}}},"/cases":{"get":{"summary":"List saved investigations","operationId":"listInvestigations","security":[{"ZaviaKey":[]}],"responses":{"200":{"description":"Successful result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseList"},"examples":{"illustrative":{"summary":"Fictional final page; nextCursor=null ends pagination","value":{"cases":[{"id":"dddddddd-dddd-4ddd-8ddd-dddddddddddd","companyId":"123456","companyName":"EXAMPLE LIMITED","countryCode":"GB","status":"active","createdAt":1794124800,"updatedAt":1794124800}],"nextCursor":null}}}}}},"400":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedJson":{"summary":"Malformed JSON","value":{"error":{"code":"invalid_request","message":"Send a valid JSON object."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"401":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidKey":{"summary":"Missing, expired or revoked key","value":{"error":{"code":"invalid_api_key","message":"The API key is invalid, expired or revoked."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"402":{"description":"Paid report credit is required; do not retry without adding credit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"reportCredit":{"summary":"Paid report credit required","value":{"error":{"code":"report_purchase_required","message":"Paid report credit is required."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"403":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"readOnlyKey":{"summary":"Full access required","value":{"error":{"code":"insufficient_scope","message":"This key is read-only. Use a full-access key to start or resume investigations."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"404":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"caseNotFound":{"summary":"Case unavailable in this workspace","value":{"error":{"code":"case_not_found","message":"Investigation not found in this workspace."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"409":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"inputChanged":{"summary":"Same run ID with different inputs","value":{"error":{"code":"run_input_changed","message":"This request belongs to different search or ownership settings. Start a new investigation."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"inProgress":{"summary":"Concurrent request for the same run","value":{"error":{"code":"run_in_progress","message":"The investigation is already running. Retry the same run ID."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"terminalFailure":{"summary":"Failed run; original reservation released","value":{"error":{"code":"run_failed","message":"The previous attempt ended and its check was released. Start the investigation again."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"410":{"description":"The upstream investigation job expired; start a new run with a new UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"expiredJob":{"summary":"Upstream job expired","value":{"error":{"code":"ubo_job_expired","message":"The upstream investigation job has expired."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"413":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"bodyTooLarge":{"summary":"JSON body exceeds the limit","value":{"error":{"code":"request_too_large","message":"The request body is too large."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"415":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"contentType":{"summary":"Content type must be application/json","value":{"error":{"code":"unsupported_media_type","message":"Send application/json."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"422":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidFields":{"summary":"Request validation failed","value":{"error":{"code":"invalid_request","message":"country: Invalid"},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"429":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rateLimit":{"summary":"Retry after the Retry-After header delay","value":{"error":{"code":"rate_limited","message":"One data request per second per workspace, shared across API keys and MCP. Retry after one second."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"searchAllowance":{"summary":"Daily API search allowance exhausted","value":{"error":{"code":"search_limit_reached","message":"The daily API search allowance has been reached."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for the per-workspace rate limit; delay in seconds."}}},"503":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"temporarilyUnavailable":{"summary":"Service temporarily unavailable","value":{"error":{"code":"temporarily_unavailable","message":"The API request could not complete. Retry shortly."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}}},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"example":20},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":300},"description":"Opaque nextCursor returned by the preceding page.","example":"eyJ1cGRhdGVkQXQiOjE3OTQxMjQ4MDAsImlkIjoiZGRkZGRkZGQtZGRkZC00ZGRkLThkZGQtZGRkZGRkZGRkZGRkIn0="}]}},"/cases/{caseId}":{"get":{"summary":"Read a saved ownership report","operationId":"getInvestigation","security":[{"ZaviaKey":[]}],"responses":{"200":{"description":"Successful result.","content":{"application/json":{"schema":{"type":"object","required":["id","report"],"properties":{"id":{"type":"string","format":"uuid"},"report":{"$ref":"#/components/schemas/Report"}}},"examples":{"illustrative":{"summary":"Fictional saved report; retrieving it does not create another charge","value":{"id":"dddddddd-dddd-4ddd-8ddd-dddddddddddd","report":{"status":"ok","subject":{"id":"123456","name":"EXAMPLE LIMITED","countryCode":"GB","status":"Active","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}},"query":{"identifier":"EXAMPLE LIMITED","country":"GB","subdivision":""},"ubo":{"company":{"id":"123456","name":"EXAMPLE LIMITED","country_code":"GB","status":"Active"},"summary":{"as_of":"2026-11-08","threshold":25,"max_depth":10,"max_depth_reached":1,"total_ubos":1,"determination":"partial","chain_complete":false,"ubo_determination_conclusive":false,"percentages_are_minimum":true,"risk_flags":[],"data_warnings":["Ownership beyond Example Holdings is unavailable."],"ownership_breakdown":{"ubo_percentage":70,"below_threshold_person_percentage":0,"listed_entity_percentage":0,"unresolved_entity_percentage":30,"untraced_percentage":0,"total_percentage":100},"enrichment":{"mode":"internal","status":"not_requested","units_consumed":0}},"data":[{"id":"example-person","full_name":"Alex Example","first_name":"Alex","last_name":"Example","nationality":null,"date_of_birth":null,"address":null,"status":null,"ceased_on":null,"notified_on":null,"country_of_residence":null,"is_pep":null,"control_types":["ownership"],"ownership":{"direct_percentage":70,"indirect_percentage":0,"effective_percentage":70,"voting_percentage":null,"has_direct_ownership":true,"has_indirect_ownership":false},"paths_total":1,"paths_truncated":false,"paths":[{"type":"direct","depth":1,"path_percentage":70,"nodes":[{"name":"EXAMPLE LIMITED","type":"company","level":0,"entity_id":"123456","country_code":"GB"},{"name":"Alex Example","type":"person","level":1,"entity_id":"example-person","percentage":70,"percentage_derived":false}]}],"provenance":{"source":null,"source_type":null,"determination_type":"calculated","retrieved_at":"2026-11-08T08:00:00Z"}}],"terminal_entities":[{"entity_id":"654321","name":"EXAMPLE HOLDINGS","type":"company","country_code":"GB","effective_percentage":30,"reason":"Ownership information unavailable","path":[{"name":"EXAMPLE LIMITED","type":"company","level":0,"entity_id":"123456","country_code":"GB"},{"name":"EXAMPLE HOLDINGS","type":"company","level":1,"entity_id":"654321","country_code":"GB","percentage":30,"percentage_derived":false}]}],"total_results":1,"total_pages":1},"summary":{"directShareholderCount":2,"currentPercentageTotal":100,"shareholderSetComplete":true,"ownershipChainComplete":false,"ownershipPathCount":1,"corporateBranchCount":1},"shareholders":[{"id":"example-person","name":"Alex Example","type":"person","percentage":70,"status":"current","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"eligibleForOwnershipCalculation":true,"identityEligibleForAutomation":false,"issueCodes":["source_unavailable"]},{"id":"654321","name":"EXAMPLE HOLDINGS","type":"company","percentage":30,"status":"current","source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"linkedCompanyId":"654321","eligibleForOwnershipCalculation":true,"identityEligibleForAutomation":false,"issueCodes":["source_unavailable"]}],"officers":{"status":"unavailable","checkedAt":"2026-11-08T08:00:00Z","candidates":[],"excludedCount":0,"message":"Officer evidence was unavailable in this fictional example."},"ownershipPaths":[{"personName":"Alex Example","identityBasis":"provider_person_id","effectivePercentage":70,"provisional":true,"path":[{"companyId":"123456","companyName":"EXAMPLE LIMITED","companyCountryCode":"GB","holderName":"Alex Example","holderType":"person","edgePercentage":70,"effectivePercentage":70,"source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[]}]}],"ultimateBeneficialOwners":[{"personName":"Alex Example","identityBasis":"provider_person_id","effectivePercentage":70,"exceedsThreshold":true,"pathCount":1,"source":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}}],"corporateBranches":[{"holderName":"EXAMPLE HOLDINGS","directPercentage":30,"effectivePercentage":30,"ownershipSource":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"},"materialSources":[{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}],"identitySources":[],"status":"unavailable","issueCodes":["ownership_unavailable"],"path":["EXAMPLE LIMITED","EXAMPLE HOLDINGS"]}],"group":{"status":"not_found","usedForOwnershipCalculation":false,"path":[],"nodes":[]},"calculation":{"thresholdPercentage":25,"denominatorTolerance":0.5,"provenance":{"name":"Illustrative source; no registry finding","category":"Example","provenanceClass":"unresolved","provenanceState":"unresolved","retrievedAt":"2026-11-08T08:00:00Z"}},"retrievalTrace":[],"warnings":["Fictional example. Source provenance and part of the ownership chain are unavailable."],"unresolvedGaps":["Unresolved corporate ownership: 30%","Source provenance is unavailable."],"determinationOutcome":"incomplete","billing":{"units":1,"reason":"ownership_evidence","message":"Usable partial ownership evidence was returned."},"isSample":false,"previewOnly":false,"generatedAt":"2026-11-08T08:00:00Z","requestId":"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee"}}}}}}},"400":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedJson":{"summary":"Malformed JSON","value":{"error":{"code":"invalid_request","message":"Send a valid JSON object."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"401":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidKey":{"summary":"Missing, expired or revoked key","value":{"error":{"code":"invalid_api_key","message":"The API key is invalid, expired or revoked."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"402":{"description":"Paid report credit is required; do not retry without adding credit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"reportCredit":{"summary":"Paid report credit required","value":{"error":{"code":"report_purchase_required","message":"Paid report credit is required."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"403":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"readOnlyKey":{"summary":"Full access required","value":{"error":{"code":"insufficient_scope","message":"This key is read-only. Use a full-access key to start or resume investigations."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"404":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"caseNotFound":{"summary":"Case unavailable in this workspace","value":{"error":{"code":"case_not_found","message":"Investigation not found in this workspace."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"409":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"inputChanged":{"summary":"Same run ID with different inputs","value":{"error":{"code":"run_input_changed","message":"This request belongs to different search or ownership settings. Start a new investigation."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"inProgress":{"summary":"Concurrent request for the same run","value":{"error":{"code":"run_in_progress","message":"The investigation is already running. Retry the same run ID."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"terminalFailure":{"summary":"Failed run; original reservation released","value":{"error":{"code":"run_failed","message":"The previous attempt ended and its check was released. Start the investigation again."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"410":{"description":"The upstream investigation job expired; start a new run with a new UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"expiredJob":{"summary":"Upstream job expired","value":{"error":{"code":"ubo_job_expired","message":"The upstream investigation job has expired."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"413":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"bodyTooLarge":{"summary":"JSON body exceeds the limit","value":{"error":{"code":"request_too_large","message":"The request body is too large."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"415":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"contentType":{"summary":"Content type must be application/json","value":{"error":{"code":"unsupported_media_type","message":"Send application/json."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"422":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidFields":{"summary":"Request validation failed","value":{"error":{"code":"invalid_request","message":"country: Invalid"},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"429":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rateLimit":{"summary":"Retry after the Retry-After header delay","value":{"error":{"code":"rate_limited","message":"One data request per second per workspace, shared across API keys and MCP. Retry after one second."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"searchAllowance":{"summary":"Daily API search allowance exhausted","value":{"error":{"code":"search_limit_reached","message":"The daily API search allowance has been reached."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for the per-workspace rate limit; delay in seconds."}}},"503":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"temporarilyUnavailable":{"summary":"Service temporarily unavailable","value":{"error":{"code":"temporarily_unavailable","message":"The API request could not complete. Retry shortly."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"example":"dddddddd-dddd-4ddd-8ddd-dddddddddddd"}]}},"/usage":{"get":{"summary":"Check connection and remaining workspace allowance","operationId":"getUsage","security":[{"ZaviaKey":[]}],"responses":{"200":{"description":"Successful result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"},"examples":{"paidWorkspace":{"summary":"Illustrative report-credit balance; use your actual returned limits","value":{"workspace":{"id":"example-workspace","name":"Example workspace","plan":"Pay as you go"},"investigations":{"used":1,"reserved":0,"remaining":1,"limit":2,"windowStart":1793491200,"windowEnd":1796083200},"searches":{"used":1,"limit":100,"remaining":99,"resetsAt":1794182400},"limits":{"requestsPerSecond":1,"maxActiveKeys":5}}},"freeWorkspace":{"summary":"Free company previews are separate from paid ownership reports","value":{"workspace":{"id":"example-workspace","name":"Example workspace","plan":"Free"},"investigations":{"used":0,"reserved":0,"remaining":0,"limit":0,"windowStart":1794096000,"windowEnd":1794182400},"companyPreviews":{"used":0,"remaining":3,"limit":3,"resetsAt":1794182400},"searches":{"used":1,"limit":3,"remaining":2,"resetsAt":1794182400},"limits":{"requestsPerSecond":1,"maxActiveKeys":5}}}}}}},"400":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"malformedJson":{"summary":"Malformed JSON","value":{"error":{"code":"invalid_request","message":"Send a valid JSON object."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"401":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidKey":{"summary":"Missing, expired or revoked key","value":{"error":{"code":"invalid_api_key","message":"The API key is invalid, expired or revoked."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"402":{"description":"Paid report credit is required; do not retry without adding credit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"reportCredit":{"summary":"Paid report credit required","value":{"error":{"code":"report_purchase_required","message":"Paid report credit is required."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"403":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"readOnlyKey":{"summary":"Full access required","value":{"error":{"code":"insufficient_scope","message":"This key is read-only. Use a full-access key to start or resume investigations."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"404":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"caseNotFound":{"summary":"Case unavailable in this workspace","value":{"error":{"code":"case_not_found","message":"Investigation not found in this workspace."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"409":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"inputChanged":{"summary":"Same run ID with different inputs","value":{"error":{"code":"run_input_changed","message":"This request belongs to different search or ownership settings. Start a new investigation."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"inProgress":{"summary":"Concurrent request for the same run","value":{"error":{"code":"run_in_progress","message":"The investigation is already running. Retry the same run ID."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"terminalFailure":{"summary":"Failed run; original reservation released","value":{"error":{"code":"run_failed","message":"The previous attempt ended and its check was released. Start the investigation again."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"410":{"description":"The upstream investigation job expired; start a new run with a new UUID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"expiredJob":{"summary":"Upstream job expired","value":{"error":{"code":"ubo_job_expired","message":"The upstream investigation job has expired."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"413":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"bodyTooLarge":{"summary":"JSON body exceeds the limit","value":{"error":{"code":"request_too_large","message":"The request body is too large."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"415":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"contentType":{"summary":"Content type must be application/json","value":{"error":{"code":"unsupported_media_type","message":"Send application/json."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"422":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"invalidFields":{"summary":"Request validation failed","value":{"error":{"code":"invalid_request","message":"country: Invalid"},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}},"429":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"rateLimit":{"summary":"Retry after the Retry-After header delay","value":{"error":{"code":"rate_limited","message":"One data request per second per workspace, shared across API keys and MCP. Retry after one second."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}},"searchAllowance":{"summary":"Daily API search allowance exhausted","value":{"error":{"code":"search_limit_reached","message":"The daily API search allowance has been reached."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Present for the per-workspace rate limit; delay in seconds."}}},"503":{"description":"Request failed; inspect error.code and error.message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"temporarilyUnavailable":{"summary":"Service temporarily unavailable","value":{"error":{"code":"temporarily_unavailable","message":"The API request could not complete. Retry shortly."},"requestId":"cccccccc-cccc-4ccc-8ccc-cccccccccccc"}}}}},"headers":{}}}}}},"components":{"securitySchemes":{"ZaviaKey":{"type":"http","scheme":"bearer","bearerFormat":"zvk_…","description":"Create a key in Dashboard → API keys. Send it as Authorization: Bearer YOUR_ZAVIA_KEY."}},"schemas":{"SearchInput":{"type":"object","additionalProperties":false,"properties":{"identifier":{"type":"string","minLength":2,"maxLength":200,"description":"Company legal name, registration number or VAT number."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter country code, for example GB."},"subdivision":{"type":"string","maxLength":80,"description":"Optional US state or Canadian jurisdiction."}},"required":["identifier","country"]},"InvestigationInput":{"type":"object","additionalProperties":false,"properties":{"identifier":{"type":"string","minLength":2,"maxLength":200,"description":"Company legal name, registration number or VAT number."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter country code, for example GB."},"subdivision":{"type":"string","maxLength":80,"description":"Optional US state or Canadian jurisdiction."},"selectedCompanyId":{"type":"string","pattern":"^[1-9]\\d{0,18}$","description":"Exact company ID returned by search; never invent an ID."},"runId":{"type":"string","format":"uuid","description":"Generate once per investigation. Reuse the same ID and inputs when resuming or retrying."},"resume":{"type":"boolean"},"cancel":{"type":"boolean"},"threshold":{"type":"number","enum":[25,10,5,1],"default":25,"description":"Ownership is strictly above this percentage. Control-based owners may also be returned below it; preserve control_types."},"maxDepth":{"type":"integer","minimum":1,"maximum":10,"default":10,"description":"Ownership reports require paid report credit. Standard reports support up to ten layers."},"purpose":{"type":"string","enum":["ownership","onboarding","supplier","group","investigation"],"default":"ownership"}},"required":["identifier","country","selectedCompanyId","runId"]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"requestId":{"type":"string"}}},"Company":{"type":"object","required":["id","name","countryCode"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"countryCode":{"type":"string"},"jurisdiction":{"type":"string"},"region":{"type":"string"},"registrationNumber":{"type":"string"},"registeredAddress":{"type":"string"},"vatNumber":{"type":"string"},"status":{"type":"string"},"incorporationDate":{"type":"string"},"legalForm":{"type":"string"},"websiteUrl":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"},"addressSource":{"$ref":"#/components/schemas/Source"},"contactSource":{"$ref":"#/components/schemas/Source"},"matchedOn":{"type":"array","items":{"enum":["legal_name","registration_number","vat_number"]}}},"additionalProperties":true},"SearchResult":{"type":"object","required":["candidates"],"properties":{"status":{"const":"ok"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/Company"}},"selectionRequired":{"type":"boolean"},"searchComplete":{"type":"boolean"},"query":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}},"requestId":{"type":"string"}},"additionalProperties":true},"Report":{"type":"object","required":["subject"],"properties":{"status":{"const":"ok"},"subject":{"$ref":"#/components/schemas/Company"},"query":{"$ref":"#/components/schemas/Query"},"ubo":{"$ref":"#/components/schemas/UboResult"},"summary":{"$ref":"#/components/schemas/ReportSummary"},"shareholders":{"type":"array","items":{"$ref":"#/components/schemas/Shareholder"}},"officers":{"$ref":"#/components/schemas/OfficerEvidence"},"ownershipPaths":{"type":"array","items":{"$ref":"#/components/schemas/OwnershipPath"}},"ultimateBeneficialOwners":{"type":"array","items":{"$ref":"#/components/schemas/CalculatedOwner"}},"corporateBranches":{"type":"array","items":{"$ref":"#/components/schemas/CorporateBranch"}},"group":{"$ref":"#/components/schemas/GroupContext"},"calculation":{"$ref":"#/components/schemas/Calculation"},"ownershipExploration":{"$ref":"#/components/schemas/OwnershipExploration"},"retrievalTrace":{"type":"array","items":{"$ref":"#/components/schemas/RetrievalCall"}},"publicResearch":{"type":"object","additionalProperties":true,"description":"Optional legacy supplementary public-web research. Separate from Global Database evidence; never treat it as verified ownership. New API investigations do not run public-web research."},"warnings":{"type":"array","items":{"type":"string"}},"unresolvedGaps":{"type":"array","items":{"type":"string"}},"determinationOutcome":{"enum":["resolved","incomplete","conflicting","no_conclusion"]},"billing":{"$ref":"#/components/schemas/Billing"},"isSample":{"type":"boolean"},"previewOnly":{"type":"boolean"},"generatedAt":{"type":"string","format":"date-time"},"requestId":{"type":"string"}},"additionalProperties":true},"InvestigationResult":{"allOf":[{"$ref":"#/components/schemas/Report"},{"type":"object","required":["caseId"],"properties":{"caseId":{"type":"string","format":"uuid"}}}]},"CaseList":{"type":"object","required":["cases","nextCursor"],"properties":{"cases":{"type":"array","items":{"type":"object","required":["id","companyId","companyName"],"properties":{"id":{"type":"string","format":"uuid"},"companyId":{"type":"string"},"companyName":{"type":"string"},"countryCode":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"integer"},"updatedAt":{"type":"integer"}}}},"nextCursor":{"type":["string","null"]}}},"Usage":{"type":"object","required":["workspace","investigations","searches","limits"],"properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"plan":{"type":"string"}}},"investigations":{"type":"object","description":"Ownership report credit only. Free workspaces return zero. Reserved reports are already excluded from remaining.","properties":{"used":{"type":"integer"},"reserved":{"type":"integer"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"windowStart":{"type":"integer"},"windowEnd":{"type":"integer"}}},"companyPreviews":{"type":"object","description":"Present on free workspaces. Website company previews do not include ownership reports.","properties":{"used":{"type":"integer"},"remaining":{"type":"integer"},"limit":{"type":"integer"},"resetsAt":{"type":"integer"}}},"searches":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"},"resetsAt":{"type":"integer"}}},"limits":{"type":"object","properties":{"requestsPerSecond":{"const":1},"maxActiveKeys":{"const":5}}}}},"Query":{"type":"object","properties":{"identifier":{"type":"string"},"country":{"type":"string"},"subdivision":{"type":"string"},"legalName":{"type":"string"},"registrationNumber":{"type":"string"},"vatNumber":{"type":"string"}},"required":["identifier","country","subdivision"],"additionalProperties":true},"Shareholder":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"enum":["person","company","unknown"]},"percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"status":{"enum":["current","historical","unknown"]},"shareType":{"type":"string"},"linkedCompanyId":{"type":"string"},"holderRegistrationNumber":{"type":"string"},"holderCountryCode":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"},"materialSources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"identitySources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"identitySource":{"$ref":"#/components/schemas/Source"},"identityIssueCode":{"type":"string"},"eligibleForOwnershipCalculation":{"type":"boolean"},"identityEligibleForAutomation":{"type":"boolean"},"issueCodes":{"type":"array","items":{"type":"string"}}},"required":["id","name","type","percentage","status","source","materialSources","identitySources","eligibleForOwnershipCalculation","identityEligibleForAutomation","issueCodes"],"additionalProperties":true},"OfficerCandidate":{"type":"object","properties":{"id":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"role":{"type":"string"},"companyId":{"type":"string"},"origin":{"enum":["registry","ubo_summary","professional"]},"status":{"enum":["current","unknown"]},"appointedAt":{"type":"string"},"reason":{"type":"string"},"identitySource":{"$ref":"#/components/schemas/Source"},"appointmentSource":{"$ref":"#/components/schemas/Source"},"profile":{"type":"object","properties":{"status":{"enum":["matched","not_found","mismatch","unavailable"]},"checkedAt":{"type":"string"},"role":{"type":"string"},"companyName":{"type":"string"},"companyId":{"type":"string"},"linkedin":{"type":"string"},"headline":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}},"required":["id","name","role","companyId","origin","status","reason","identitySource","appointmentSource"],"additionalProperties":true},"OfficerEvidence":{"type":"object","properties":{"status":{"enum":["available","empty","unavailable","partial"]},"checkedAt":{"type":"string"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/OfficerCandidate"}},"excludedCount":{"type":"integer","minimum":0},"message":{"type":"string"}},"required":["status","checkedAt","candidates","excludedCount","message"],"additionalProperties":true,"description":"Filtered senior-officer candidates, capped at 200. Excludes irrelevant or former appointments; not a complete director register, verified control person, or automatic SMO designation."},"CorporateBranch":{"type":"object","properties":{"holderName":{"type":"string"},"directPercentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"effectivePercentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"ownershipSource":{"$ref":"#/components/schemas/Source"},"materialSources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"identitySources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"status":{"enum":["resolved","not_found","ambiguous","unavailable","cycle","depth_limit","branch_limit","incomplete_shareholders"]},"issueCodes":{"type":"array","items":{"type":"string"}},"path":{"type":"array","items":{"type":"string"}},"resolutionBasis":{"enum":["linked_provider_id","group_modelled_company_id","exact_scoped_kyb_search"]},"identityResolutionSource":{"$ref":"#/components/schemas/Source"},"resolvedCompany":{"$ref":"#/components/schemas/Company"}},"required":["holderName","directPercentage","effectivePercentage","ownershipSource","materialSources","identitySources","status","issueCodes","path"],"additionalProperties":true},"GroupNode":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"countryCode":{"type":"string"},"selected":{"type":"boolean"},"children":{"type":"array","items":{"$ref":"#/components/schemas/GroupNode"}}},"required":["id","name","countryCode","selected","children"],"additionalProperties":true},"GroupContext":{"type":"object","properties":{"status":{"enum":["available","not_found","unavailable","not_requested"]},"usedForOwnershipCalculation":{"const":false},"path":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"countryCode":{"type":"string"}},"required":["name"],"additionalProperties":true}},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/GroupNode"}},"source":{"$ref":"#/components/schemas/Source"}},"required":["status","usedForOwnershipCalculation","path","nodes"],"additionalProperties":true,"description":"Corporate group context; never a source of ownership percentages. Read provenance before treating relationships as registry evidence."},"CalculatedOwner":{"type":"object","properties":{"personName":{"type":"string"},"identityBasis":{"enum":["single_exact_normalized_name","provider_person_id"]},"effectivePercentage":{"type":"number"},"exceedsThreshold":{"type":"boolean"},"pathCount":{"type":"integer","minimum":0},"source":{"$ref":"#/components/schemas/Source"}},"required":["personName","identityBasis","effectivePercentage","exceedsThreshold","pathCount","source"],"additionalProperties":true,"description":"Compatibility display view. Use ubo.data as the authoritative result: owners with unknown percentages are omitted here, and control-based owners can have exceedsThreshold=false."},"Calculation":{"type":"object","properties":{"thresholdPercentage":{"type":"number"},"denominatorTolerance":{"type":"number"},"provenance":{"$ref":"#/components/schemas/Source"}},"required":["thresholdPercentage","denominatorTolerance","provenance"],"additionalProperties":true},"OwnershipExploration":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/UboResult"},"retrievedAt":{"type":"string"},"notice":{"type":"string"}},"required":["retrievedAt"],"additionalProperties":true,"description":"Optional separate 1% canvas snapshot. Does not replace the original finding. A missing result means wider coverage was unavailable."},"RetrievalCall":{"type":"object","properties":{"operation":{"type":"string"},"endpoint":{"type":"string"},"status":{"enum":["succeeded","not_found","validation_failed","failed"]},"httpStatus":{"type":["integer","null"]},"durationMs":{"type":"number","minimum":0},"page":{"type":"integer","minimum":0},"recordCount":{"type":"integer","minimum":0},"retrievedAt":{"type":"string"}},"required":["operation","endpoint","status","httpStatus","durationMs","retrievedAt"],"additionalProperties":true},"Source":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri"},"provenanceClass":{"enum":["official_registry","global_database_modelled","enriched","unresolved","calculation"]},"provenanceState":{"enum":["official_registry","global_database_modelled","enriched","unresolved","calculation"]},"retrievedAt":{"type":"string"},"basedOn":{"type":"string"}},"required":["name","category","provenanceClass","provenanceState"],"additionalProperties":true},"UboProvenance":{"type":"object","properties":{"source":{"type":["object","null"],"properties":{"name":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri"}},"additionalProperties":true},"source_type":{"type":["string","null"]},"determination_type":{"type":["string","null"]},"retrieved_at":{"type":["string","null"]}},"additionalProperties":true},"UboNode":{"type":"object","properties":{"name":{"type":"string"},"type":{"enum":["company","person"]},"level":{"type":"integer","minimum":0},"entity_id":{"type":["string","number","null"],"description":"Original source record identifier; preserve it as returned."},"country_code":{"type":["string","null"]},"percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"percentage_derived":{"type":"boolean"},"provenance":{"$ref":"#/components/schemas/UboProvenance"}},"required":["name","type"],"additionalProperties":true},"UboPath":{"type":"object","properties":{"type":{"type":"string"},"depth":{"type":"integer","minimum":0},"path_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/UboNode"}}},"required":["nodes","path_percentage"],"additionalProperties":true},"UboPerson":{"type":"object","properties":{"id":{"type":"string"},"full_name":{"type":"string"},"first_name":{"type":["string","null"]},"last_name":{"type":["string","null"]},"nationality":{"type":["string","null"]},"date_of_birth":{"type":["object","null"],"description":"Month and year only when supplied. The provider does not return a birth day.","properties":{"month":{"type":["integer","null"]},"year":{"type":["integer","null"]}}},"address":{"type":["object","null"],"description":"Locality, postal code and country only when supplied. The provider does not return a street address here.","properties":{"locality":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"country_code":{"type":["string","null"]}}},"status":{"type":["string","null"],"description":"Reserved provider field, currently null. Absence is not a negative finding."},"ceased_on":{"type":["string","null"],"description":"Reserved provider field, currently null. Absence is not a negative finding."},"notified_on":{"type":["string","null"],"description":"Reserved provider field, currently null. Absence is not a negative finding."},"country_of_residence":{"type":["string","null"],"description":"Reserved provider field, currently null. Absence is not a negative finding."},"is_pep":{"type":["boolean","null"],"description":"Reserved provider field, currently null. This API does not perform PEP screening; null does not mean the person is not a PEP."},"control_types":{"type":"array","items":{"type":"string"}},"ownership":{"type":"object","properties":{"direct_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"indirect_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"effective_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"voting_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Reserved provider field, currently null; not evidence of voting control."},"has_direct_ownership":{"type":"boolean"},"has_indirect_ownership":{"type":"boolean"},"range":{"description":"Original ownership-band evidence when supplied; do not convert a band to an exact percentage."}},"required":["direct_percentage","indirect_percentage","effective_percentage"],"additionalProperties":true},"paths_total":{"type":"integer","minimum":0},"paths_truncated":{"type":"boolean"},"paths":{"type":"array","items":{"$ref":"#/components/schemas/UboPath"}},"provenance":{"$ref":"#/components/schemas/UboProvenance"}},"required":["id","full_name","control_types","ownership","paths_total","paths_truncated","paths"],"additionalProperties":true},"UboTerminal":{"type":"object","properties":{"entity_id":{"type":["string","number","null"]},"name":{"type":"string"},"type":{"type":"string"},"country_code":{"type":["string","null"]},"effective_percentage":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Null means unknown, not zero. Check percentages_are_minimum before treating a value as exact."},"reason":{"type":"string"},"path":{"type":"array","items":{"$ref":"#/components/schemas/UboNode"}}},"required":["name","effective_percentage","reason","path"],"additionalProperties":true},"UboSummary":{"type":"object","properties":{"as_of":{"type":"string"},"threshold":{"type":"number"},"max_depth":{"type":"integer","minimum":0},"max_depth_reached":{"type":"integer","minimum":0},"total_ubos":{"type":"integer","minimum":0},"determination":{"enum":["calculated","partial","none_identified","listed_parent","exempt_listed","not_available"]},"chain_complete":{"type":"boolean"},"ubo_determination_conclusive":{"type":"boolean"},"percentages_are_minimum":{"type":"boolean"},"risk_flags":{"type":"array","items":{"type":"string"}},"data_warnings":{"type":"array","items":{"type":"string"}},"ownership_breakdown":{"type":["object","null"],"properties":{"ubo_percentage":{"type":"number","minimum":0,"maximum":100},"below_threshold_person_percentage":{"type":"number","minimum":0,"maximum":100},"listed_entity_percentage":{"type":"number","minimum":0,"maximum":100},"unresolved_entity_percentage":{"type":"number","minimum":0,"maximum":100},"untraced_percentage":{"type":"number","minimum":0,"maximum":100},"total_percentage":{"type":"number","minimum":0,"maximum":100}}},"senior_managing_officials":{"type":"array","items":{"type":"object","properties":{"officer_id":{"type":"string"},"full_name":{"type":"string"},"officer_role":{"type":"string"}},"additionalProperties":true}},"enrichment":{"type":"object","properties":{"mode":{"type":"string"},"status":{"type":"string"},"job_id":{"type":["string","null"]},"entities_requested":{"type":"integer","minimum":0},"entities_enriched":{"type":"integer","minimum":0},"reports_pending":{"type":"integer","minimum":0},"units_consumed":{"type":"integer","minimum":0},"budget_exhausted":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]}},"additionalProperties":true}},"required":["threshold","max_depth","total_ubos","determination","chain_complete","ubo_determination_conclusive","percentages_are_minimum","risk_flags","data_warnings","ownership_breakdown"],"additionalProperties":true},"UboResult":{"type":"object","properties":{"company":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"country_code":{"type":"string"},"registration_number":{"type":"string"},"status":{"type":"string"}},"required":["id","name","country_code"],"additionalProperties":true},"summary":{"$ref":"#/components/schemas/UboSummary"},"data":{"type":"array","items":{"$ref":"#/components/schemas/UboPerson"}},"terminal_entities":{"type":"array","items":{"$ref":"#/components/schemas/UboTerminal"}},"total_results":{"type":"integer","minimum":0},"total_pages":{"type":"integer","minimum":0}},"required":["company","summary","data","terminal_entities","total_results","total_pages"],"additionalProperties":true},"OwnershipEdge":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"companyCountryCode":{"type":"string"},"holderName":{"type":"string"},"holderType":{"enum":["person","company"]},"holderCompanyId":{"type":"string"},"holderCountryCode":{"type":"string"},"edgePercentage":{"type":"number"},"effectivePercentage":{"type":"number"},"source":{"$ref":"#/components/schemas/Source"},"materialSources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"identitySources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"identityResolutionSource":{"$ref":"#/components/schemas/Source"},"calculationSource":{"$ref":"#/components/schemas/Source"}},"additionalProperties":true},"OwnershipPath":{"type":"object","properties":{"personName":{"type":"string"},"identityBasis":{"enum":["single_exact_normalized_name","provider_person_id"]},"effectivePercentage":{"type":"number"},"path":{"type":"array","items":{"$ref":"#/components/schemas/OwnershipEdge"}},"provisional":{"type":"boolean"}},"required":["personName","effectivePercentage","path","provisional"],"additionalProperties":true},"Billing":{"type":"object","properties":{"units":{"type":"integer","enum":[0,1]},"reason":{"enum":["free_preview","ownership_evidence","no_ownership_evidence"]},"message":{"type":"string"}},"required":["units","reason","message"],"additionalProperties":true},"ReportSummary":{"type":"object","properties":{"directShareholderCount":{"type":"integer","minimum":0},"currentPercentageTotal":{"type":["number","null"],"minimum":0,"description":"Sum of reported shareholder percentages. Can exceed 100 when evidence conflicts; preserve it and review warnings rather than clamping it."},"shareholderSetComplete":{"type":"boolean"},"ownershipChainComplete":{"type":"boolean"},"ownershipPathCount":{"type":"integer","minimum":0},"corporateBranchCount":{"type":"integer","minimum":0}},"additionalProperties":true},"Processing":{"type":"object","properties":{"status":{"const":"processing"},"runId":{"type":"string","format":"uuid"},"retryAfterSeconds":{"type":"integer","minimum":1},"message":{"type":"string"},"progress":{"type":"object","properties":{"entitiesResolved":{"type":"integer","minimum":0},"entitiesPending":{"type":"integer","minimum":0},"currentDepth":{"type":"integer","minimum":0}},"additionalProperties":true}},"required":["status","runId","retryAfterSeconds"],"additionalProperties":true}}}}