{"openapi":"3.1.0","info":{"title":"Companybook Agent API","version":"0.3.0","description":"Authenticated, bounded graph reads for Plus accounts. Beta: no invoices. Basic fields cost zero credits but are metered; /me and /capabilities work on every plan."},"servers":[{"url":"https://api.companybook.co/v1"},{"url":"https://companybook.co/api/v1","description":"Same API on the website origin (kept for existing clients)."}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal Companybook API key or OAuth access token."}}},"paths":{"/resolve":{"get":{"operationId":"cb_resolve","summary":"Resolve an exact identifier or a company, person, market entity, belief tradition, support fact, support scheme, scheme period, or verified public actor.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":300}},{"name":"types","in":"query","required":false,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":20},{"type":"null"}]}}},"description":"JSON-encoded query value."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","enum":["org","person","property","entity","belief_tradition","support_fact","support_scheme","support_scheme_period","public_actor","state_finance_node"]},"name":{"type":["string","null"]},"score":{"type":"number"}},"required":["id","type","name","score"],"additionalProperties":false},"maxItems":50},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1},"missing":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"type":"null"},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/entities/{id}":{"get":{"operationId":"cb_getSingle","summary":"Get safe domain payloads for up to 25 node IDs (100 on Plus). Graph edges are returned only for predicates named in `include` (a bounded page; [\"*\"] for all); each entity lists its active_predicates. Optional `extend` adds per-organisation financial_history (all non-consolidated years), subunits (50 per org in a batch, up to 1000 when one ID is requested; data.extensions_truncated names cut lists), web_identities and group_parent. A request for exactly one organisation also carries signature_text/procuration_text with signature_status/procuration_status (available, none, or unavailable = read the register manually) from Brreg. Basic data costs 0 credits but is metered. The influencer dataset requires Plus and may consume credits (currently 1 beta credit per delivered record); repeating the call can debit credits again. Beta usage is not invoiced.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"dataset","in":"query","required":false,"schema":{"type":"string","enum":["basic","influencer"],"default":"basic"}},{"name":"include","in":"query","required":false,"content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"maxItems":30,"default":[]}}},"description":"JSON-encoded query value."},{"name":"extend","in":"query","required":false,"content":{"application/json":{"schema":{"type":"array","items":{"type":"string","enum":["financial_history","subunits","web_identities","group_parent"]},"maxItems":4,"default":[]}}},"description":"JSON-encoded query value."},{"name":"as_of","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","required":false,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"}]},"maxItems":5},{"type":"null"}]}}},"description":"JSON-encoded query value."}],"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"anyOf":[{"type":"object","properties":{"entities":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_fact"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"source":{"type":"string"},"grant_key":{"type":"string"},"recipient_org_nr":{"type":["string","null"]},"active":{"type":"boolean"},"fact_revision":{"type":["string","null"]},"budget_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"date_precision":{"type":["string","null"]},"award_date":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"support_form":{"type":["string","null"]},"source_url":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"role_resolution_status":{"type":"string"},"source_snapshot_id":{"type":["string","null"]},"source_checksum":{"type":["string","null"]},"source_observed_at":{"type":["string","null"]},"source_period":{"type":["string","null"]},"period_kind":{"type":["string","null"]},"reference_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"amount_status":{"type":["string","null"]},"payment_status":{"type":["string","null"]}},"required":["source","grant_key","recipient_org_nr","active","fact_revision","budget_year","date_precision","award_date","amount_basis","amount","currency","amount_precision","amount_lower_bound","amount_upper_bound","amount_range_currency","support_form","source_url","reporting_complete","scheme_node_id","period_node_id","role_resolution_status","source_snapshot_id","source_checksum","source_observed_at"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_scheme"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"namespace":{"type":"string"},"scheme_id":{"type":"string"},"name":{"type":["string","null"]},"source_url":{"type":["string","null"]},"identity_status":{"type":"string"}},"required":["namespace","scheme_id","name","source_url","identity_status"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_scheme_period"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"scheme_node_id":{"type":"string"},"period_key":{"type":"string"},"budget_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"metadata_status":{"type":"string"},"source_url":{"type":["string","null"]}},"required":["scheme_node_id","period_key","budget_year","metadata_status","source_url"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"public_actor"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"namespace":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"},"country_code":{"type":["string","null"]},"source_url":{"type":"string"},"verified_at":{"type":"string","format":"date-time"}},"required":["namespace","identifier","name","country_code","source_url","verified_at"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"state_finance_node"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"node_type":{"type":"string","enum":["account","program_area","program_category","ministry","chapter","post","account_class","account_group","art","ministry_entity","entity","accountant"]},"node_key":{"type":"string"},"code":{"type":"string"},"active_actor_bindings":{"type":"array","items":{"type":"object","properties":{"org_nr":{"type":"string","pattern":"^\\d{9}$"},"binding_role":{"type":"string","enum":["responsible_ministry","accounting_entity","reporting_entity"]},"verification_method":{"type":"string","enum":["official_register","official_document","manual_review"]},"source_url":{"type":"string","format":"uri"},"verified_at":{"type":"string","format":"date-time"}},"required":["org_nr","binding_role","verification_method","source_url","verified_at"],"additionalProperties":false},"maxItems":25}},"required":["node_type","node_key","code","active_actor_bindings"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"org"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"org_nr":{"type":["string","null"]},"name":{"type":["string","null"]},"org_form":{"type":["string","null"]},"nace_code":{"type":["string","null"]},"nace_description":{"type":["string","null"]},"municipality":{"type":["string","null"]},"municipality_code":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"address":{"type":["string","null"]},"registration_date":{"type":["string","null"]},"founded_date":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_bankrupt":{"type":["boolean","null"]},"is_liquidating":{"type":["boolean","null"]},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_profit":{"anyOf":[{"type":"number"},{"type":"null"}]},"equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"financial_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"entity_type":{"type":["string","null"]},"parent_org_nr":{"type":["string","null"]},"org_form_description":{"type":["string","null"]},"secondary_nace_code":{"type":["string","null"]},"secondary_nace_description":{"type":["string","null"]},"sector_code":{"type":["string","null"]},"postal_address":{"type":["string","null"]},"postal_address_postal_code":{"type":["string","null"]},"postal_address_city":{"type":["string","null"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_in_group":{"type":["boolean","null"]},"is_under_forced_liquidation":{"type":["boolean","null"]},"is_deleted":{"type":["boolean","null"]},"deleted_at":{"type":["string","null"]},"cessation_date":{"type":["string","null"]},"last_annual_report_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"registered_in_vat":{"type":["boolean","null"]},"share_capital":{"anyOf":[{"type":"number"},{"type":"null"}]},"share_capital_currency":{"type":["string","null"]},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"capital_registered_at":{"type":["string","null"]},"vedtekts_date":{"type":["string","null"]},"purpose":{"type":["string","null"]},"purpose_lines":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"activity":{"type":["string","null"]},"activity_lines":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"signature_text":{"type":["string","null"]},"signature_status":{"type":"string","enum":["available","unavailable","none"]},"procuration_text":{"type":["string","null"]},"procuration_status":{"type":"string","enum":["available","unavailable","none"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"person"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"uid":{"type":["string","null"]},"name":{"type":["string","null"]},"birth_year":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"property"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"matrikkelnummer":{"type":["string","null"]},"kommunenummer":{"type":["string","null"]},"gardsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"bruksnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"festenummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"seksjonsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"building"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"bygningsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"building_type":{"type":["string","null"]},"status":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"address"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"street":{"type":["string","null"]},"nummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"bokstav":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"municipality_code":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"identity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"identity_type":{"type":["string","null"]},"normalized_identifier":{"type":["string","null"]},"display_name":{"type":["string","null"]},"url":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"entity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"canonical_name":{"type":["string","null"]},"entity_type":{"type":["string","null"]},"description":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"belief_tradition"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"code":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"parent_code":{"type":["string","null"]},"source_url":{"type":["string","null"]}},"required":["code","slug","name"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"group"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"system_code":{"type":["string","null"]},"system_name":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"party"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"code":{"type":["string","null"]},"name":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"tender"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"doffin_id":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"published_at":{"type":["string","null"]},"deadline":{"type":["string","null"]},"cpv_codes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"article"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"title":{"type":["string","null"]},"url":{"type":["string","null"]},"published_at":{"type":["string","null"]},"source":{"type":["string","null"]},"summary":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"ip"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"application_number":{"type":["string","null"]},"title":{"type":["string","null"]},"ip_type":{"type":["string","null"]},"status":{"type":["string","null"]},"filing_date":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"license"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"business_name":{"type":["string","null"]},"license_type":{"type":["string","null"]},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false}]},"maxItems":100},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"src":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"dst":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"predicate":{"type":"string"},"props":{"type":"object","properties":{"support_fact_id":{"type":["string","null"]},"source":{"type":["string","null"]},"fact_revision":{"type":["string","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"period_key":{"type":["string","null"]},"identity_status":{"type":["string","null"]},"metadata_status":{"type":["string","null"]},"role":{"type":["string","null"]},"role_code":{"type":["string","null"]},"role_name":{"type":["string","null"]},"share_class":{"type":["string","null"]},"data_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"total_shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"ownership_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"variant":{"type":["string","null"]},"context_key":{"type":["string","null"]},"scoring_version":{"type":["string","null"]},"rank":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"score":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"grant_key":{"type":["string","null"]},"contribution_id":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"integer"}]},{"type":"null"}]},"published_at":{"type":["string","null"]},"budget_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"date_precision":{"type":["string","null"]},"grant_date":{"type":["string","null"]},"programme":{"type":["string","null"]},"scheme_id":{"type":["string","null"]},"scheme_url":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"support_kind":{"type":["string","null"]},"support_form":{"type":["string","null"]},"cross_source_overlap":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"administrator_org_nr":{"type":["string","null"]},"administrator_name":{"type":["string","null"]},"provider_metadata_status":{"type":["string","null"]},"department_org_nr":{"type":["string","null"]},"department_name":{"type":["string","null"]},"provider_org_nr":{"type":["string","null"]},"provider_name":{"type":["string","null"]},"provider_role":{"type":["string","null"]},"source_url":{"type":["string","null"]},"external_grant_id":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"applied_amount_nok":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"detail_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"assertion_source":{"type":["string","null"]},"community_id":{"type":["string","null"]},"registration_active":{"type":["boolean","null"]},"relationship_type":{"type":["string","null"]},"temporal_basis":{"type":["string","null"]},"fiscal_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"snapshot_id":{"type":["string","null"]},"observation_id":{"type":["string","null"]},"evidence_level":{"anyOf":[{"type":"string","enum":["direct_observed","documented_allocation","scheme_derived","unresolved"]},{"type":"null"}]},"binding_role":{"type":["string","null"]}},"additionalProperties":false},"confidence":{"type":"number","minimum":0,"maximum":1},"evidence_id":{"type":"integer","exclusiveMinimum":0},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"valid_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"recorded_at":{"type":"string","format":"date-time"}},"required":["id","src","dst","predicate","props","confidence","evidence_id"],"additionalProperties":false},"maxItems":50},"extensions":{"type":"object","properties":{"financial_history":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"fiscal_year":{"type":"integer"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_costs":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_result":{"anyOf":[{"type":"number"},{"type":"null"}]},"result_before_tax":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_result":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"type":["string","null"]}},"required":["fiscal_year"],"additionalProperties":false},"maxItems":30},"propertyNames":{"pattern":"^\\d{9}$"}},"subunits":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"org_nr":{"type":"string"},"name":{"type":["string","null"]},"parent_org_nr":{"type":"string"},"industry_code":{"type":["string","null"]},"industry_description":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"address_street":{"type":["string","null"]},"address_postal_code":{"type":["string","null"]},"address_city":{"type":["string","null"]},"address_municipality_code":{"type":["string","null"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_deleted":{"type":["boolean","null"]},"cessation_date":{"type":["string","null"]},"nace_code":{"type":["string","null"]},"nace_description":{"type":["string","null"]},"address":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"municipality_code":{"type":["string","null"]}},"required":["id","org_nr","parent_org_nr"],"additionalProperties":false},"maxItems":1000},"propertyNames":{"pattern":"^\\d{9}$"}},"web_identities":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"identity_type":{"type":["string","null"]},"normalized_identifier":{"type":["string","null"]},"display_name":{"type":["string","null"]},"full_url":{"type":["string","null"]},"is_primary":{"type":["boolean","null"]},"site_kind":{"type":["string","null"]},"site_status":{"type":["string","null"]}},"additionalProperties":false},"maxItems":10},"propertyNames":{"pattern":"^\\d{9}$"}},"group_parent":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"org_nr":{"type":"string"},"name":{"type":["string","null"]},"depth":{"type":"integer"}},"required":["id","org_nr","depth"],"additionalProperties":false},{"type":"null"}]},"propertyNames":{"pattern":"^\\d{9}$"}}},"additionalProperties":false},"extensions_truncated":{"type":"object","properties":{"subunits":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"},"maxItems":100}},"additionalProperties":false}},"required":["entities","edges"],"additionalProperties":false},{"type":"object","properties":{"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^cb:identity:instagram:[a-zA-Z0-9._]{1,30}$"},"type":{"type":"string","const":"identity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"username":{"type":"string","pattern":"^[a-zA-Z0-9._]{1,30}$"},"full_name":{"type":["string","null"]},"followers_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"posts_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_private":{"type":["boolean","null"]}},"required":["username","full_name","followers_count","following_count","posts_count","is_private"],"additionalProperties":false}},"required":["id","type","name","payload"],"additionalProperties":false},"maxItems":25}},"required":["entities"],"additionalProperties":false}]},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":100},"missing":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":100},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"anyOf":[{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string"},{"type":"integer","exclusiveMinimum":0}]},{"type":"null"}]},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/entities/batch":{"post":{"operationId":"cb_get","summary":"Get safe domain payloads for up to 25 node IDs (100 on Plus). Graph edges are returned only for predicates named in `include` (a bounded page; [\"*\"] for all); each entity lists its active_predicates. Optional `extend` adds per-organisation financial_history (all non-consolidated years), subunits (50 per org in a batch, up to 1000 when one ID is requested; data.extensions_truncated names cut lists), web_identities and group_parent. A request for exactly one organisation also carries signature_text/procuration_text with signature_status/procuration_status (available, none, or unavailable = read the register manually) from Brreg. Basic data costs 0 credits but is metered. The influencer dataset requires Plus and may consume credits (currently 1 beta credit per delivered record); repeating the call can debit credits again. Beta usage is not invoiced.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":1,"maxItems":100},"dataset":{"type":"string","enum":["basic","influencer"],"default":"basic"},"include":{"type":"array","items":{"type":"string"},"maxItems":30,"default":[]},"extend":{"type":"array","items":{"type":"string","enum":["financial_history","subunits","web_identities","group_parent"]},"maxItems":4,"default":[]},"as_of":{"type":"string","format":"date-time"},"cursor":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"}]},"maxItems":5},{"type":"null"}]}},"required":["ids"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"anyOf":[{"type":"object","properties":{"entities":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_fact"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"source":{"type":"string"},"grant_key":{"type":"string"},"recipient_org_nr":{"type":["string","null"]},"active":{"type":"boolean"},"fact_revision":{"type":["string","null"]},"budget_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"date_precision":{"type":["string","null"]},"award_date":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"support_form":{"type":["string","null"]},"source_url":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"role_resolution_status":{"type":"string"},"source_snapshot_id":{"type":["string","null"]},"source_checksum":{"type":["string","null"]},"source_observed_at":{"type":["string","null"]},"source_period":{"type":["string","null"]},"period_kind":{"type":["string","null"]},"reference_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"amount_status":{"type":["string","null"]},"payment_status":{"type":["string","null"]}},"required":["source","grant_key","recipient_org_nr","active","fact_revision","budget_year","date_precision","award_date","amount_basis","amount","currency","amount_precision","amount_lower_bound","amount_upper_bound","amount_range_currency","support_form","source_url","reporting_complete","scheme_node_id","period_node_id","role_resolution_status","source_snapshot_id","source_checksum","source_observed_at"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_scheme"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"namespace":{"type":"string"},"scheme_id":{"type":"string"},"name":{"type":["string","null"]},"source_url":{"type":["string","null"]},"identity_status":{"type":"string"}},"required":["namespace","scheme_id","name","source_url","identity_status"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"support_scheme_period"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"scheme_node_id":{"type":"string"},"period_key":{"type":"string"},"budget_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"metadata_status":{"type":"string"},"source_url":{"type":["string","null"]}},"required":["scheme_node_id","period_key","budget_year","metadata_status","source_url"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"public_actor"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"namespace":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"},"country_code":{"type":["string","null"]},"source_url":{"type":"string"},"verified_at":{"type":"string","format":"date-time"}},"required":["namespace","identifier","name","country_code","source_url","verified_at"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"state_finance_node"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"node_type":{"type":"string","enum":["account","program_area","program_category","ministry","chapter","post","account_class","account_group","art","ministry_entity","entity","accountant"]},"node_key":{"type":"string"},"code":{"type":"string"},"active_actor_bindings":{"type":"array","items":{"type":"object","properties":{"org_nr":{"type":"string","pattern":"^\\d{9}$"},"binding_role":{"type":"string","enum":["responsible_ministry","accounting_entity","reporting_entity"]},"verification_method":{"type":"string","enum":["official_register","official_document","manual_review"]},"source_url":{"type":"string","format":"uri"},"verified_at":{"type":"string","format":"date-time"}},"required":["org_nr","binding_role","verification_method","source_url","verified_at"],"additionalProperties":false},"maxItems":25}},"required":["node_type","node_key","code","active_actor_bindings"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"org"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"org_nr":{"type":["string","null"]},"name":{"type":["string","null"]},"org_form":{"type":["string","null"]},"nace_code":{"type":["string","null"]},"nace_description":{"type":["string","null"]},"municipality":{"type":["string","null"]},"municipality_code":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"address":{"type":["string","null"]},"registration_date":{"type":["string","null"]},"founded_date":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_bankrupt":{"type":["boolean","null"]},"is_liquidating":{"type":["boolean","null"]},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_profit":{"anyOf":[{"type":"number"},{"type":"null"}]},"equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"financial_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"entity_type":{"type":["string","null"]},"parent_org_nr":{"type":["string","null"]},"org_form_description":{"type":["string","null"]},"secondary_nace_code":{"type":["string","null"]},"secondary_nace_description":{"type":["string","null"]},"sector_code":{"type":["string","null"]},"postal_address":{"type":["string","null"]},"postal_address_postal_code":{"type":["string","null"]},"postal_address_city":{"type":["string","null"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_in_group":{"type":["boolean","null"]},"is_under_forced_liquidation":{"type":["boolean","null"]},"is_deleted":{"type":["boolean","null"]},"deleted_at":{"type":["string","null"]},"cessation_date":{"type":["string","null"]},"last_annual_report_year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"registered_in_vat":{"type":["boolean","null"]},"share_capital":{"anyOf":[{"type":"number"},{"type":"null"}]},"share_capital_currency":{"type":["string","null"]},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"capital_registered_at":{"type":["string","null"]},"vedtekts_date":{"type":["string","null"]},"purpose":{"type":["string","null"]},"purpose_lines":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"activity":{"type":["string","null"]},"activity_lines":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"signature_text":{"type":["string","null"]},"signature_status":{"type":"string","enum":["available","unavailable","none"]},"procuration_text":{"type":["string","null"]},"procuration_status":{"type":"string","enum":["available","unavailable","none"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"person"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"uid":{"type":["string","null"]},"name":{"type":["string","null"]},"birth_year":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"property"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"matrikkelnummer":{"type":["string","null"]},"kommunenummer":{"type":["string","null"]},"gardsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"bruksnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"festenummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"seksjonsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"building"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"bygningsnummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"building_type":{"type":["string","null"]},"status":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"address"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"street":{"type":["string","null"]},"nummer":{"anyOf":[{"type":"integer"},{"type":"null"}]},"bokstav":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"municipality_code":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"identity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"identity_type":{"type":["string","null"]},"normalized_identifier":{"type":["string","null"]},"display_name":{"type":["string","null"]},"url":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"entity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"canonical_name":{"type":["string","null"]},"entity_type":{"type":["string","null"]},"description":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"belief_tradition"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"code":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"parent_code":{"type":["string","null"]},"source_url":{"type":["string","null"]}},"required":["code","slug","name"],"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"group"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"system_code":{"type":["string","null"]},"system_name":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"party"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"code":{"type":["string","null"]},"name":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"tender"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"doffin_id":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"published_at":{"type":["string","null"]},"deadline":{"type":["string","null"]},"cpv_codes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"article"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"title":{"type":["string","null"]},"url":{"type":["string","null"]},"published_at":{"type":["string","null"]},"source":{"type":["string","null"]},"summary":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"ip"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"application_number":{"type":["string","null"]},"title":{"type":["string","null"]},"ip_type":{"type":["string","null"]},"status":{"type":["string","null"]},"filing_date":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"type":{"type":"string","const":"license"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"business_name":{"type":["string","null"]},"license_type":{"type":["string","null"]},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}},"additionalProperties":false},"active_predicates":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["id","type","name","payload"],"additionalProperties":false}]},"maxItems":100},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"src":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"dst":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"predicate":{"type":"string"},"props":{"type":"object","properties":{"support_fact_id":{"type":["string","null"]},"source":{"type":["string","null"]},"fact_revision":{"type":["string","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"period_key":{"type":["string","null"]},"identity_status":{"type":["string","null"]},"metadata_status":{"type":["string","null"]},"role":{"type":["string","null"]},"role_code":{"type":["string","null"]},"role_name":{"type":["string","null"]},"share_class":{"type":["string","null"]},"data_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"total_shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"ownership_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"variant":{"type":["string","null"]},"context_key":{"type":["string","null"]},"scoring_version":{"type":["string","null"]},"rank":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"score":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"grant_key":{"type":["string","null"]},"contribution_id":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"integer"}]},{"type":"null"}]},"published_at":{"type":["string","null"]},"budget_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"date_precision":{"type":["string","null"]},"grant_date":{"type":["string","null"]},"programme":{"type":["string","null"]},"scheme_id":{"type":["string","null"]},"scheme_url":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"support_kind":{"type":["string","null"]},"support_form":{"type":["string","null"]},"cross_source_overlap":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"administrator_org_nr":{"type":["string","null"]},"administrator_name":{"type":["string","null"]},"provider_metadata_status":{"type":["string","null"]},"department_org_nr":{"type":["string","null"]},"department_name":{"type":["string","null"]},"provider_org_nr":{"type":["string","null"]},"provider_name":{"type":["string","null"]},"provider_role":{"type":["string","null"]},"source_url":{"type":["string","null"]},"external_grant_id":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"applied_amount_nok":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"detail_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"assertion_source":{"type":["string","null"]},"community_id":{"type":["string","null"]},"registration_active":{"type":["boolean","null"]},"relationship_type":{"type":["string","null"]},"temporal_basis":{"type":["string","null"]},"fiscal_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"snapshot_id":{"type":["string","null"]},"observation_id":{"type":["string","null"]},"evidence_level":{"anyOf":[{"type":"string","enum":["direct_observed","documented_allocation","scheme_derived","unresolved"]},{"type":"null"}]},"binding_role":{"type":["string","null"]}},"additionalProperties":false},"confidence":{"type":"number","minimum":0,"maximum":1},"evidence_id":{"type":"integer","exclusiveMinimum":0},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"valid_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"recorded_at":{"type":"string","format":"date-time"}},"required":["id","src","dst","predicate","props","confidence","evidence_id"],"additionalProperties":false},"maxItems":50},"extensions":{"type":"object","properties":{"financial_history":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"fiscal_year":{"type":"integer"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_costs":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_result":{"anyOf":[{"type":"number"},{"type":"null"}]},"result_before_tax":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_result":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"type":["string","null"]}},"required":["fiscal_year"],"additionalProperties":false},"maxItems":30},"propertyNames":{"pattern":"^\\d{9}$"}},"subunits":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"org_nr":{"type":"string"},"name":{"type":["string","null"]},"parent_org_nr":{"type":"string"},"industry_code":{"type":["string","null"]},"industry_description":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"address_street":{"type":["string","null"]},"address_postal_code":{"type":["string","null"]},"address_city":{"type":["string","null"]},"address_municipality_code":{"type":["string","null"]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_deleted":{"type":["boolean","null"]},"cessation_date":{"type":["string","null"]},"nace_code":{"type":["string","null"]},"nace_description":{"type":["string","null"]},"address":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"municipality_code":{"type":["string","null"]}},"required":["id","org_nr","parent_org_nr"],"additionalProperties":false},"maxItems":1000},"propertyNames":{"pattern":"^\\d{9}$"}},"web_identities":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"identity_type":{"type":["string","null"]},"normalized_identifier":{"type":["string","null"]},"display_name":{"type":["string","null"]},"full_url":{"type":["string","null"]},"is_primary":{"type":["boolean","null"]},"site_kind":{"type":["string","null"]},"site_status":{"type":["string","null"]}},"additionalProperties":false},"maxItems":10},"propertyNames":{"pattern":"^\\d{9}$"}},"group_parent":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"org_nr":{"type":"string"},"name":{"type":["string","null"]},"depth":{"type":"integer"}},"required":["id","org_nr","depth"],"additionalProperties":false},{"type":"null"}]},"propertyNames":{"pattern":"^\\d{9}$"}}},"additionalProperties":false},"extensions_truncated":{"type":"object","properties":{"subunits":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"},"maxItems":100}},"additionalProperties":false}},"required":["entities","edges"],"additionalProperties":false},{"type":"object","properties":{"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^cb:identity:instagram:[a-zA-Z0-9._]{1,30}$"},"type":{"type":"string","const":"identity"},"name":{"type":["string","null"]},"payload":{"type":"object","properties":{"username":{"type":"string","pattern":"^[a-zA-Z0-9._]{1,30}$"},"full_name":{"type":["string","null"]},"followers_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"posts_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"is_private":{"type":["boolean","null"]}},"required":["username","full_name","followers_count","following_count","posts_count","is_private"],"additionalProperties":false}},"required":["id","type","name","payload"],"additionalProperties":false},"maxItems":25}},"required":["entities"],"additionalProperties":false}]},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":100},"missing":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":100},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"anyOf":[{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string"},{"type":"integer","exclusiveMinimum":0}]},{"type":"null"}]},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/search":{"post":{"operationId":"cb_search","summary":"Search companies using structured filters and bounded cursor pagination.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","properties":{"municipality":{"type":"string","maxLength":10},"nace_prefix":{"type":"string","maxLength":20},"revenue_min":{"type":"number"},"revenue_max":{"type":"number"},"org_form":{"type":"string","maxLength":30},"has_predicate":{"type":"string","maxLength":100}},"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"cursor":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"}]},"maxItems":5},{"type":"null"}]}},"required":["filter"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"name":{"type":["string","null"]},"score":{"type":"number"}},"required":["id","name","score"],"additionalProperties":false},"maxItems":100},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"object","properties":{"municipality":{"type":"string","maxLength":10},"nace_prefix":{"type":"string","maxLength":20},"revenue_min":{"type":"number"},"revenue_max":{"type":"number"},"org_form":{"type":"string","maxLength":30},"has_predicate":{"type":"string","maxLength":100}},"additionalProperties":false},"missing":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"anyOf":[{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"number"},{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."}]},{"type":"null"}]},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/traversals":{"post":{"operationId":"cb_traverse","summary":"Traverse typed graph edges, at most three hops and 200 nodes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":1,"maxItems":25},"predicates":{"type":"array","items":{"type":"string","maxLength":100},"minItems":1,"maxItems":30},"direction":{"type":"string","enum":["in","out","both"],"default":"both"},"max_hops":{"type":"integer","minimum":1,"maximum":3,"default":1},"as_of":{"type":"string","format":"date-time"},"known_at":{"type":"string","format":"date-time"},"max_nodes":{"type":"integer","minimum":1,"maximum":200,"default":200},"per_hop":{"type":"integer","minimum":1,"maximum":200,"default":50}},"required":["from","predicates"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."}},"required":["id"],"additionalProperties":false},"maxItems":200},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"src":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"dst":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"predicate":{"type":"string"},"props":{"type":"object","properties":{"support_fact_id":{"type":["string","null"]},"source":{"type":["string","null"]},"fact_revision":{"type":["string","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"period_key":{"type":["string","null"]},"identity_status":{"type":["string","null"]},"metadata_status":{"type":["string","null"]},"role":{"type":["string","null"]},"role_code":{"type":["string","null"]},"role_name":{"type":["string","null"]},"share_class":{"type":["string","null"]},"data_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"total_shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"ownership_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"variant":{"type":["string","null"]},"context_key":{"type":["string","null"]},"scoring_version":{"type":["string","null"]},"rank":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"score":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"grant_key":{"type":["string","null"]},"contribution_id":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"integer"}]},{"type":"null"}]},"published_at":{"type":["string","null"]},"budget_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"date_precision":{"type":["string","null"]},"grant_date":{"type":["string","null"]},"programme":{"type":["string","null"]},"scheme_id":{"type":["string","null"]},"scheme_url":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"support_kind":{"type":["string","null"]},"support_form":{"type":["string","null"]},"cross_source_overlap":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"administrator_org_nr":{"type":["string","null"]},"administrator_name":{"type":["string","null"]},"provider_metadata_status":{"type":["string","null"]},"department_org_nr":{"type":["string","null"]},"department_name":{"type":["string","null"]},"provider_org_nr":{"type":["string","null"]},"provider_name":{"type":["string","null"]},"provider_role":{"type":["string","null"]},"source_url":{"type":["string","null"]},"external_grant_id":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"applied_amount_nok":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"detail_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"assertion_source":{"type":["string","null"]},"community_id":{"type":["string","null"]},"registration_active":{"type":["boolean","null"]},"relationship_type":{"type":["string","null"]},"temporal_basis":{"type":["string","null"]},"fiscal_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"snapshot_id":{"type":["string","null"]},"observation_id":{"type":["string","null"]},"evidence_level":{"anyOf":[{"type":"string","enum":["direct_observed","documented_allocation","scheme_derived","unresolved"]},{"type":"null"}]},"binding_role":{"type":["string","null"]}},"additionalProperties":false},"confidence":{"type":"number","minimum":0,"maximum":1},"evidence_id":{"type":"integer","exclusiveMinimum":0},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"valid_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"recorded_at":{"type":"string","format":"date-time"}},"required":["id","src","dst","predicate","props","confidence","evidence_id"],"additionalProperties":false},"maxItems":600}},"required":["nodes","edges"],"additionalProperties":false},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":25},"missing":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"type":"null"},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/signals":{"get":{"operationId":"cb_signals","summary":"Read dated signals with stable cursor pagination, at most 100 per page.","parameters":[{"name":"ids","in":"query","required":false,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string","minLength":3,"maxLength":300},"minItems":1,"maxItems":25},{"type":"null"}]}}},"description":"JSON-encoded query value."},{"name":"families","in":"query","required":false,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":100},"maxItems":30},{"type":"null"}]}}},"description":"JSON-encoded query value."},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","minimum":0,"default":0}},{"name":"as_of","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":100}},{"name":"cursor","in":"query","required":false,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"}]},"maxItems":5},{"type":"null"}]}}},"description":"JSON-encoded query value."}],"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"node_id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"related_node_id":{"type":["string","null"],"description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"family":{"type":"string"},"type":{"type":"string"},"occurred_at":{"type":"string","format":"date-time"},"recorded_at":{"type":"string","format":"date-time"},"summary":{"type":["string","null"]},"score":{"type":"number"},"strength":{"type":"number","minimum":0},"evidence_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]}},"required":["id","node_id","related_node_id","family","type","occurred_at","recorded_at","summary","score","strength","evidence_id"],"additionalProperties":false},"maxItems":100},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"object","properties":{"ids":{"anyOf":[{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":25},{"type":"null"}]},"families":{"anyOf":[{"type":"array","items":{"type":"string"},"maxItems":30},{"type":"null"}]}},"required":["ids","families"],"additionalProperties":false},"missing":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"anyOf":[{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string","format":"date-time"},{"type":"integer","exclusiveMinimum":0}]},{"type":"null"}]},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/explanations":{"get":{"operationId":"cb_explain","summary":"Explain exactly one edge or signal using public evidence metadata.","parameters":[{"name":"edge_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]}},{"name":"signal_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]}}],"responses":{"200":{"description":"cb/v1 public-field envelope; cost contains measured units and credits.","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"string","const":"cb/v1"},"request_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"data":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"edge"},"item":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"src":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"dst":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"predicate":{"type":"string"},"props":{"type":"object","properties":{"support_fact_id":{"type":["string","null"]},"source":{"type":["string","null"]},"fact_revision":{"type":["string","null"]},"scheme_node_id":{"type":["string","null"]},"period_node_id":{"type":["string","null"]},"period_key":{"type":["string","null"]},"identity_status":{"type":["string","null"]},"metadata_status":{"type":["string","null"]},"role":{"type":["string","null"]},"role_code":{"type":["string","null"]},"role_name":{"type":["string","null"]},"share_class":{"type":["string","null"]},"data_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"total_shares":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"ownership_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"share_percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"percentage":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"currency":{"type":["string","null"]},"year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"variant":{"type":["string","null"]},"context_key":{"type":["string","null"]},"scoring_version":{"type":["string","null"]},"rank":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"score":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"grant_key":{"type":["string","null"]},"contribution_id":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"integer"}]},{"type":"null"}]},"published_at":{"type":["string","null"]},"budget_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"date_precision":{"type":["string","null"]},"grant_date":{"type":["string","null"]},"programme":{"type":["string","null"]},"scheme_id":{"type":["string","null"]},"scheme_url":{"type":["string","null"]},"amount_lower_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_upper_bound":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"amount_range_currency":{"type":["string","null"]},"amount_precision":{"type":["string","null"]},"support_kind":{"type":["string","null"]},"support_form":{"type":["string","null"]},"cross_source_overlap":{"type":["string","null"]},"amount_basis":{"type":["string","null"]},"administrator_org_nr":{"type":["string","null"]},"administrator_name":{"type":["string","null"]},"provider_metadata_status":{"type":["string","null"]},"department_org_nr":{"type":["string","null"]},"department_name":{"type":["string","null"]},"provider_org_nr":{"type":["string","null"]},"provider_name":{"type":["string","null"]},"provider_role":{"type":["string","null"]},"source_url":{"type":["string","null"]},"external_grant_id":{"type":["string","null"]},"reporting_complete":{"type":["boolean","null"]},"applied_amount_nok":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"detail_count":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"assertion_source":{"type":["string","null"]},"community_id":{"type":["string","null"]},"registration_active":{"type":["boolean","null"]},"relationship_type":{"type":["string","null"]},"temporal_basis":{"type":["string","null"]},"fiscal_year":{"anyOf":[{"anyOf":[{"type":"number"},{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?(?:[eE][+-]?\\d+)?$"}]},{"type":"null"}]},"snapshot_id":{"type":["string","null"]},"observation_id":{"type":["string","null"]},"evidence_level":{"anyOf":[{"type":"string","enum":["direct_observed","documented_allocation","scheme_derived","unresolved"]},{"type":"null"}]},"binding_role":{"type":["string","null"]}},"additionalProperties":false},"confidence":{"type":"number","minimum":0,"maximum":1},"evidence_id":{"type":"integer","exclusiveMinimum":0},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"valid_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"recorded_at":{"type":"string","format":"date-time"}},"required":["id","src","dst","predicate","props","confidence","evidence_id"],"additionalProperties":false},"predicate_label":{"type":"string"},"evidence":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"source":{"type":"string"},"source_url":{"type":["string","null"]},"method":{"type":"string","enum":["registry","computed","inferred","crawled","llm"]},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["id","source","source_url","method","observed_at","snapshot_at"],"additionalProperties":false}},"required":["kind","item","predicate_label","evidence"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"signal"},"item":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"node_id":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"related_node_id":{"type":["string","null"],"description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"family":{"type":"string"},"type":{"type":"string"},"occurred_at":{"type":"string","format":"date-time"},"recorded_at":{"type":"string","format":"date-time"},"summary":{"type":["string","null"]},"score":{"type":"number"},"strength":{"type":"number","minimum":0},"evidence_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]}},"required":["id","node_id","related_node_id","family","type","occurred_at","recorded_at","summary","strength","evidence_id"],"additionalProperties":false},"predicate_label":{"type":"string"},"evidence":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0},"source":{"type":"string"},"source_url":{"type":["string","null"]},"method":{"type":"string","enum":["registry","computed","inferred","crawled","llm"]},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"snapshot_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["id","source","source_url","method","observed_at","snapshot_at"],"additionalProperties":false}},"required":["kind","item","predicate_label"],"additionalProperties":false},{"type":"object","properties":{},"additionalProperties":false}]},"entities":{"type":"array","items":{"type":"string","description":"Graph node identifier, normally cb:type:key. Unknown input IDs may be echoed in coverage or traversal seeds."},"maxItems":200},"evidence":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"coverage":{"type":"object","properties":{"requested":{"type":"object","properties":{"edge_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]},"signal_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"null"}]}},"required":["edge_id","signal_id"],"additionalProperties":false},"missing":{"type":"array","items":{"not":{}},"minItems":0,"maxItems":0},"reason":{"type":["string","null"]}},"required":["requested","missing","reason"],"additionalProperties":false},"truncated":{"type":"boolean"},"cursor":{"type":"null"},"next_hint":{"type":["string","null"]},"cost":{"type":"object","properties":{"units":{"type":"integer","minimum":0},"unit_type":{"type":"string","enum":["record","premium_record"]},"credits_charged":{"type":"number","minimum":0},"credits_reserved":{"type":"number","const":0},"balance":{"type":"number","minimum":0}},"required":["units","unit_type","credits_charged","credits_reserved","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["contract","request_id","as_of","data","entities","evidence","coverage","truncated","cursor","next_hint","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/capabilities":{"get":{"operationId":"capabilities","responses":{"200":{"description":"Authenticated account information","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","const":"0.3.0"},"contract":{"type":"string","const":"cb/v1"},"authentication":{"type":"array","minItems":2,"maxItems":2,"items":[{"type":"string","const":"oauth"},{"type":"string","const":"api_key"}]},"transports":{"type":"array","minItems":3,"maxItems":3,"items":[{"type":"string","const":"mcp"},{"type":"string","const":"mcp_dev"},{"type":"string","const":"rest"}]},"basic_data_credits":{"type":"number","const":0},"billing_enabled":{"type":"boolean","const":false},"limits":{"type":"object","properties":{"input_ids":{"type":"number","const":25},"page_size":{"type":"number","const":100},"traversal_hops":{"type":"number","const":3},"traversal_nodes":{"type":"number","const":200}},"required":["input_ids","page_size","traversal_hops","traversal_nodes"],"additionalProperties":false},"research":{"type":"object","properties":{"templates":{"type":"object","properties":{"company_dossier.v1":{"type":"boolean"},"social_refresh.v1":{"type":"boolean"},"company_sources.v1":{"type":"boolean"}},"required":["company_dossier.v1","social_refresh.v1","company_sources.v1"],"additionalProperties":false},"reason":{"type":"string"}},"required":["templates","reason"],"additionalProperties":false}},"required":["version","contract","authentication","transports","basic_data_credits","billing_enabled","limits","research"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/me":{"get":{"operationId":"me","responses":{"200":{"description":"Authenticated account information","content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"tier":{"type":"string","enum":["free","plus","pro"]},"plan_id":{"type":"string"},"personal_plan_id":{"type":"string"},"beta":{"type":"boolean"},"api_access":{"type":"boolean"},"entitlements":{"type":"array","items":{"type":"string"}},"dataset_grants":{"type":"array","items":{"type":"string"}},"organizations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"org_nr":{"type":["string","null"]},"role":{"type":"string","enum":["owner","admin","member","service"]},"plan_id":{"type":["string","null"]},"seats":{"anyOf":[{"type":"integer"},{"type":"null"}]},"members":{"type":"integer"},"pool":{"anyOf":[{"type":"object","properties":{"allowance":{"type":"number"},"spent":{"type":"number"},"reserved":{"type":"number"}},"required":["allowance","spent","reserved"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","org_nr","role","plan_id","seats","members","pool"],"additionalProperties":false}},"credits":{"type":"object","properties":{"monthly_allowance":{"type":"number","minimum":0},"balance":{"type":"number","minimum":0},"reserved":{"type":"number","minimum":0},"renews_at":{"type":"string"}},"required":["monthly_allowance","balance","reserved","renews_at"],"additionalProperties":false},"expense":{"type":"object","properties":{"spent_nok":{"type":"number","minimum":0},"reserved_nok":{"type":"number","minimum":0},"limit_nok":{"type":"number","minimum":0},"warning":{"type":"boolean"}},"required":["spent_nok","reserved_nok","limit_nok","warning"],"additionalProperties":false},"billing_enabled":{"type":"boolean","const":false},"price_status":{"type":"string"},"month":{"type":"string"},"credential":{"anyOf":[{"type":"object","properties":{"billed_to":{"type":"string","enum":["personal","team"]},"team":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}]},"plan_id":{"type":"string"},"credits":{"type":"object","properties":{"monthly_allowance":{"type":"number","minimum":0},"spent":{"type":"number","minimum":0},"reserved":{"type":"number","minimum":0},"balance":{"type":"number","minimum":0},"purchased":{"type":"number","minimum":0}},"required":["monthly_allowance","spent","reserved","balance"],"additionalProperties":false},"limits":{"type":"object","properties":{"requests_per_minute":{"type":"integer","minimum":0},"requests_per_day":{"type":"integer","minimum":0},"records_per_day":{"type":"integer","minimum":0},"records_per_month":{"type":"integer","minimum":0}},"required":["requests_per_minute","requests_per_day","records_per_day","records_per_month"],"additionalProperties":false},"used":{"type":"object","properties":{"requests_this_minute":{"type":"integer","minimum":0},"requests_today":{"type":"integer","minimum":0},"records_today":{"type":"integer","minimum":0},"records_this_month":{"type":"integer","minimum":0}},"required":["requests_this_minute","requests_today","records_today","records_this_month"],"additionalProperties":false},"resets":{"type":"object","properties":{"day":{"type":"string"},"month":{"type":"string"}},"required":["day","month"],"additionalProperties":false}},"required":["billed_to","team","plan_id","credits","limits","used","resets"],"additionalProperties":false},{"type":"null"}]}},"required":["user_id","tier","plan_id","personal_plan_id","beta","api_access","entitlements","dataset_grants","organizations","credits","expense","billing_enabled","price_status","month","credential"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/usage":{"get":{"operationId":"usage","responses":{"200":{"description":"Authenticated account information"},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/research-jobs/quote":{"post":{"operationId":"quoteResearch","summary":"Get the configured upper-bound price; does not start work.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"string","enum":["company_dossier.v1","social_refresh.v1","company_sources.v1"]},"org_nr":{"type":"string","pattern":"^\\d{9}$"}},"required":["template","org_nr"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Owner-scoped research quote or job. Beta billing is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"string","enum":["company_dossier.v1","social_refresh.v1","company_sources.v1"]},"org_nr":{"type":"string","pattern":"^\\d{9}$"},"max_credits":{"type":"number","exclusiveMinimum":0},"max_cost_micro_nok":{"type":"integer","exclusiveMinimum":0,"maximum":100000000},"profile_version":{"type":"string"},"price_version":{"type":"string"},"billing_enabled":{"type":"boolean","const":false},"expires_at":{"type":"string","format":"date-time"}},"required":["template","org_nr","max_credits","max_cost_micro_nok","profile_version","price_version","billing_enabled","expires_at"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/research-jobs":{"post":{"operationId":"startResearch","summary":"Reserve the maximum cost and enqueue one idempotent, bounded job.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"string","enum":["company_dossier.v1","social_refresh.v1","company_sources.v1"]},"org_nr":{"type":"string","pattern":"^\\d{9}$"},"idempotency_key":{"type":"string","minLength":8,"maxLength":128}},"required":["template","org_nr","idempotency_key"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Owner-scoped research quote or job. Beta billing is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","running","cancel_requested","succeeded","partial","failed","canceled","reconciliation_required"]},"reused":{"type":"boolean"}},"required":["ok","id","status","reused"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/research-jobs/{id}":{"get":{"operationId":"getResearch","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Owner-scoped research quote or job. Beta billing is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"template":{"type":"string","enum":["company_dossier.v1","social_refresh.v1","company_sources.v1"]},"org_nr":{"type":"string","pattern":"^\\d{9}$"},"status":{"type":"string","enum":["queued","running","cancel_requested","succeeded","partial","failed","canceled","reconciliation_required"]},"result":{"anyOf":[{"type":"object","properties":{"graph_node_ids":{"type":"array","items":{"type":"string","pattern":"^cb:[a-z_]+:[a-zA-Z0-9:_.-]+$","maxLength":300},"maxItems":200},"graph_receipt_verified":{"type":"boolean"},"profile_version":{"type":"string","maxLength":120},"price_version":{"type":"string","maxLength":120},"source_search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":310},"observed_at":{"type":"string","format":"date-time"},"coverage":{"type":"string","const":"candidate_sources"},"ownership_verified":{"type":"boolean","const":false},"candidates":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":1,"maximum":10},"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?:\\/\\/"},"title":{"type":"string","minLength":1,"maxLength":300},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},"required":["rank","url","title","description"],"additionalProperties":false},"maxItems":10}},"required":["query","observed_at","coverage","ownership_verified","candidates"],"additionalProperties":false},"method":{"type":"string","enum":["social_profiles","web_sources","company_dossier"]}},"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","template","org_nr","status","result","created_at","updated_at"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/research-jobs/{id}/cancel":{"post":{"operationId":"cancelResearch","summary":"Cancel queued work or request cancellation; running costs remain reserved until known.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Owner-scoped research quote or job. Beta billing is disabled.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"template":{"type":"string","enum":["company_dossier.v1","social_refresh.v1","company_sources.v1"]},"org_nr":{"type":"string","pattern":"^\\d{9}$"},"status":{"type":"string","enum":["queued","running","cancel_requested","succeeded","partial","failed","canceled","reconciliation_required"]},"result":{"anyOf":[{"type":"object","properties":{"graph_node_ids":{"type":"array","items":{"type":"string","pattern":"^cb:[a-z_]+:[a-zA-Z0-9:_.-]+$","maxLength":300},"maxItems":200},"graph_receipt_verified":{"type":"boolean"},"profile_version":{"type":"string","maxLength":120},"price_version":{"type":"string","maxLength":120},"source_search":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":310},"observed_at":{"type":"string","format":"date-time"},"coverage":{"type":"string","const":"candidate_sources"},"ownership_verified":{"type":"boolean","const":false},"candidates":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":1,"maximum":10},"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?:\\/\\/"},"title":{"type":"string","minLength":1,"maxLength":300},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},"required":["rank","url","title","description"],"additionalProperties":false},"maxItems":10}},"required":["query","observed_at","coverage","ownership_verified","candidates"],"additionalProperties":false},"method":{"type":"string","enum":["social_profiles","web_sources","company_dossier"]}},"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","template","org_nr","status","result","created_at","updated_at"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/gateway/ssb":{"post":{"operationId":"querySsb","summary":"Statistics Norway via the Companybook gateway: search tables, read metadata, or fetch at most 2 000 cells. Free, metered.","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"action":{"type":"string","const":"search"},"query":{"type":"string","minLength":2,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10}},"required":["action","query"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"metadata"},"table":{"type":"string","pattern":"^[0-9A-Za-z]{3,12}$"}},"required":["action","table"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"data"},"table":{"type":"string","pattern":"^[0-9A-Za-z]{3,12}$"},"selection":{"type":"object","additionalProperties":{"type":"string","maxLength":400},"propertyNames":{"maxLength":60}}},"required":["action","table","selection"],"additionalProperties":false}],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"SSB result with source URL and metered units.","content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","const":"ssb"},"request_id":{"type":"string","format":"uuid"},"action":{"type":"string","enum":["search","metadata","data"]},"tables":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"updated":{"type":"string"},"first_period":{"type":["string","null"]},"last_period":{"type":["string","null"]},"variables":{"type":"array","items":{"type":"string"}}},"required":["id","label","updated","first_period","last_period","variables"],"additionalProperties":false},"maxItems":25},"table":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"updated":{"type":["string","null"]},"variables":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"},"values":{"type":"integer"},"eliminable":{"type":"boolean"},"sample":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"],"additionalProperties":false},"maxItems":20}},"required":["code","label","values","eliminable","sample"],"additionalProperties":false}}},"required":["id","label","updated","variables"],"additionalProperties":false},"cells":{"type":"array","items":{"type":"object","properties":{"dimensions":{"type":"object","additionalProperties":{"type":"string"}},"value":{"type":["number","null"]},"status":{"type":["string","null"]}},"required":["dimensions","value","status"],"additionalProperties":false},"maxItems":2000},"source_url":{"type":"string","format":"uri"},"cost":{"type":"object","properties":{"units":{"type":"integer"},"unit_type":{"type":"string"},"credits_charged":{"type":"number"},"balance":{"type":"number"}},"required":["units","unit_type","credits_charged","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["provider","request_id","action","source_url","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/partners/{dataset}/search":{"post":{"operationId":"searchPartnerDataset","summary":"Search a licensed partner dataset. Requires a dataset grant; fixed grants are included, metered grants debit credits per delivered record.","parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string","enum":["partner_demo_news"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","maxLength":200,"default":""},"org_nr":{"type":"string","pattern":"^\\d{9}$"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Partner records and the credits charged.","content":{"application/json":{"schema":{"type":"object","properties":{"dataset":{"type":"string","const":"partner_demo_news"},"partner":{"type":"string"},"request_id":{"type":"string","format":"uuid"},"articles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"published_at":{"type":"string"},"section":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"org_nrs":{"type":"array","items":{"type":"string"}}},"required":["id","published_at","section","title","summary","org_nrs"],"additionalProperties":false},"maxItems":20},"cost":{"type":"object","properties":{"units":{"type":"integer"},"unit_type":{"type":"string","const":"article"},"pricing":{"type":"string","enum":["fixed","metered_markup"]},"credits_charged":{"type":"number"},"balance":{"type":"number"}},"required":["units","unit_type","pricing","credits_charged","balance"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["dataset","partner","request_id","articles","cost","warnings"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/lists":{"get":{"operationId":"getLists","summary":"Your saved company lists with company counts. Requires the lists scope (default for keys and OAuth).","responses":{"200":{"description":"Lists owned by the authenticated user.","content":{"application/json":{"schema":{"type":"object","properties":{"lists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"maxItems":500},"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"companies":{"type":"array","items":{"type":"object","properties":{"org_nr":{"type":"string","pattern":"^\\d{9}$"},"name":{"type":"string"},"industry":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"city":{"type":["string","null"]},"note":{"type":["string","null"]},"added_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["org_nr","name","industry","employees","city","note","added_at","url"],"additionalProperties":false},"maxItems":200},"truncated":{"type":"boolean"}},"required":["truncated"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/lists/{list}":{"get":{"operationId":"getList","summary":"Companies in one of your lists, newest first.","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"string"},"description":"List short id (from GET /lists) or exact list name."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"The list and its companies.","content":{"application/json":{"schema":{"type":"object","properties":{"lists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"maxItems":500},"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"companies":{"type":"array","items":{"type":"object","properties":{"org_nr":{"type":"string","pattern":"^\\d{9}$"},"name":{"type":"string"},"industry":{"type":["string","null"]},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}]},"city":{"type":["string","null"]},"note":{"type":["string","null"]},"added_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["org_nr","name","industry","employees","city","note","added_at","url"],"additionalProperties":false},"maxItems":200},"truncated":{"type":"boolean"}},"required":["truncated"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}},"/lists/{list}/companies":{"post":{"operationId":"addToList","summary":"Add up to 50 organisation numbers; creates the list when no list has that name.","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"string"},"description":"List short id (from GET /lists) or exact list name."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_nrs":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"},"minItems":1,"maxItems":50},"description":{"type":"string","maxLength":500,"description":"Description for a newly created list."}},"required":["org_nrs"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Added, already present and unknown organisation numbers.","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"created":{"type":"boolean"},"added":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"already_in_list":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"removed":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"not_in_list":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"unknown_org_nrs":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}}},"required":["list","created","unknown_org_nrs"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}},"delete":{"operationId":"removeFromList","summary":"Remove organisation numbers from a list. The list is kept.","parameters":[{"name":"list","in":"path","required":true,"schema":{"type":"string"},"description":"List short id (from GET /lists) or exact list name."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_nrs":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"},"minItems":1,"maxItems":50}},"required":["org_nrs"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Removed and absent organisation numbers.","content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"company_count":{"type":"integer","minimum":0},"updated_at":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["id","name","description","company_count","updated_at","url"],"additionalProperties":false},"created":{"type":"boolean"},"added":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"already_in_list":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"removed":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"not_in_list":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}},"unknown_org_nrs":{"type":"array","items":{"type":"string","pattern":"^\\d{9}$"}}},"required":["list","created","unknown_org_nrs"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}},"400":{"description":"Invalid bounded arguments or query.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"401":{"description":"Authentication required or token invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer resource-metadata challenge."}}},"402":{"description":"Available credits exhausted.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"403":{"description":"Plan (REST requires Plus), scope, dataset access, account access or spend authorization missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"404":{"description":"Route or owner-scoped resource not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"405":{"description":"Method not supported by this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"409":{"description":"Idempotency key already identifies different work.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"413":{"description":"Request body exceeds the operation limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}},"429":{"description":"Shared account volume or expense limit.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying. Do not rotate credentials to bypass limits."}}},"503":{"description":"Data, durable metering or verified execution profile unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code"],"additionalProperties":false,"properties":{"code":{"type":"string","description":"Stable machine-readable error code; no backend diagnostics."},"required_tier":{"type":"string","description":"Plan tier that unlocks this operation (plan_required)."},"upgrade_url":{"type":"string","format":"uri"}}}}}}}}}}}}}