{"openapi":"3.1.0","info":{"title":"FirmaAPI","version":"1.1.0"},"servers":[{"url":"https://firmaapi.dk"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Live keys start with cvr_live_. Each key has a separate test key (cvr_test_) that returns synthetic data and never counts against the quota."},"BearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer <key>. Same keys as X-API-Key."}},"headers":{"X-RateLimit-Limit":{"description":"Requests per second allowed for the account (not per key).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current one-second window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp (seconds) when the rate limit window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait. 1 for RATE_LIMIT_EXCEEDED; seconds until the monthly reset for MONTHLY_LIMIT_EXCEEDED.","schema":{"type":"integer"}},"X-Request-Id":{"description":"Unique id for the request. Also returned as error.request_id in error bodies; quote it when contacting support.","schema":{"type":"string","example":"req_3f9c2d7a1b0e4c5d8e9f0a1b2c3d4e5f"}},"X-Quota-Limit":{"description":"Monthly request quota for the account.","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Requests left this month.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"Unix timestamp (seconds) of the next monthly reset (midnight, Danish time, on the 1st).","schema":{"type":"integer"}},"X-Billing-Counted":{"description":"true when the call counted against the monthly quota. Validation errors (400), plan errors (403), 304 and 5xx never count.","schema":{"type":"string","enum":["true","false"]}},"WWW-Authenticate":{"description":"Authentication scheme, always Bearer.","schema":{"type":"string","example":"Bearer realm=\"FirmaAPI\""}},"ETag":{"description":"Weak validator for the response. Send it back in If-None-Match to get 304 Not Modified, which does not count against the quota.","schema":{"type":"string"}},"Deprecation":{"description":"Present (true) when the request used the deprecated cvr_test_ prefix-swap test key format.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date after which the deprecated test key format stops working.","schema":{"type":"string"}}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine readable error code, e.g. INVALID_PARAM, PLAN_UPGRADE_REQUIRED, RATE_LIMIT_EXCEEDED."},"message":{"type":"string"},"request_id":{"type":"string","description":"Same value as the X-Request-Id header."},"param":{"type":"string","description":"The offending parameter for INVALID_PARAM and OFFSET_TOO_LARGE."},"required_plan":{"type":"string","description":"PLAN_UPGRADE_REQUIRED: the lowest plan that unlocks the feature."},"current_plan":{"type":"string"},"upgrade_url":{"type":"string","format":"uri","description":"Link to pricing on plan and limit errors."},"docs_url":{"type":"string","format":"uri"},"used":{"type":"integer","description":"MONTHLY_LIMIT_EXCEEDED: requests used this month."},"limit":{"type":"integer"},"reset_at":{"type":"string","format":"date-time","description":"MONTHLY_LIMIT_EXCEEDED: when the quota resets (midnight, Danish time, on the 1st)."},"retry_after":{"type":"integer","description":"Seconds to wait, same as the Retry-After header."},"legacy_code":{"type":"string","description":"Deprecated code kept during a transition period (PLAN_NOT_SUPPORTED until 2027-05-01)."}},"required":["code","message"]}},"required":["error"]},"UsageResponse":{"type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"},"reset_at":{"type":"string","format":"date-time"},"period":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"time_zone":{"type":"string","example":"Europe/Copenhagen"}}},"rate_limit":{"type":"object","properties":{"requests_per_second":{"type":"integer"}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"requests":{"type":"integer"}},"required":["date","requests"]}},"upgrade_url":{"type":"string","format":"uri"},"meta":{"type":"object","properties":{"counts_against_quota":{"type":"boolean"}}}},"required":["plan","used","limit","remaining","reset_at","daily"],"example":{"plan":{"id":"basis","name":"Basis"},"used":1250,"limit":50000,"remaining":48750,"reset_at":"2026-11-30T23:00:00.000Z","period":{"start":"2026-10-31T23:00:00.000Z","end":"2026-11-30T23:00:00.000Z","time_zone":"Europe/Copenhagen"},"rate_limit":{"requests_per_second":5},"daily":[{"date":"2026-11-01","requests":830},{"date":"2026-11-02","requests":420}],"upgrade_url":"https://firmaapi.dk/priser","meta":{"counts_against_quota":false}}},"CompanyProvenance":{"type":"object","properties":{"source":{"type":"string","enum":["redis","postgres","erst"]},"resolution_rule":{"type":"string","enum":["cache_hit","db_row","fresh_fetch","background_refresh"]}},"required":["source","resolution_rule"]},"CompanyMeta":{"type":"object","properties":{"cached_at":{"type":"string","format":"date-time"},"data_age_seconds":{"type":"integer"},"source":{"type":"string"},"provenance":{"type":"object","properties":{"source":{"type":"string","enum":["redis","postgres","erst"]},"resolution_rule":{"type":"string","enum":["cache_hit","db_row","fresh_fetch","background_refresh"]}},"required":["source","resolution_rule"]}},"required":["cached_at","data_age_seconds","source","provenance"]},"CompanyBase":{"type":"object","properties":{"cvr":{"type":"string"},"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]}},"required":["cvr","name"]},"CompanyOwner":{"type":"object","description":"Legacy owner/participant shape kept for backwards compatibility. It can mix active participant, ownership and governance roles. Prefer history.register_entries for legal owners and executives/board_members for management in new integrations.","deprecated":true,"properties":{"name":{"type":"string"},"title":{"type":["string","null"]},"ownership_share":{"type":["number","null"]},"voting_share":{"type":["number","null"]},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"participant_cvr":{"type":["string","null"],"description":"Best known CVR for a company participant. When ERST only sends participant_enhedsnummer, FirmaAPI can fill in the CVR from its local company cache. null for persons, foreign participants and participants not resolved yet."},"participant_enhedsnummer":{"type":["string","null"]},"person_id":{"type":["string","null"],"format":"uuid","description":"Person profile UUID for GET /api/v1/person/{id}. Only on the Professionel/Enterprise plans. null when the participant is a company or no profile matched."}},"required":["name"]},"CompanyAuditor":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":["string","null"]},"joined_date":{"type":["string","null"]},"participant_cvr":{"type":["string","null"],"description":"Best known CVR for the auditor or company participant. May be filled in by a participant_enhedsnummer lookup in the local cache."},"participant_enhedsnummer":{"type":["string","null"]},"person_id":{"type":["string","null"],"format":"uuid","description":"Person profile UUID for GET /api/v1/person/{id}. Only on the Professionel/Enterprise plans. null when the auditor is a company (typical) or no profile matched."}},"required":["name"]},"CompanyOwnershipHistoryEntry":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":["string","null"]},"ownership_share":{"type":["number","null"]},"voting_share":{"type":["number","null"]},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"participant_cvr":{"type":["string","null"],"description":"Best known CVR for a historical company participant. May be filled in by a participant_enhedsnummer lookup in the local cache."},"participant_enhedsnummer":{"type":["string","null"]},"active":{"type":["boolean","null"]},"person_id":{"type":["string","null"],"format":"uuid","description":"Person profile UUID for GET /api/v1/person/{id}. Only on the Professionel/Enterprise plans."}},"required":["name"]},"CompanySimpleHistoryEntry":{"type":"object","properties":{"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}}},"CompanyHistoryName":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}]},"CompanyHistoryAddress":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"address":{"type":"string"},"zipcode":{"type":"string"},"city":{"type":"string"},"municipality_code":{"type":["integer","null"]},"municipality_name":{"type":["string","null"]}},"required":["address","zipcode","city","municipality_code","municipality_name"]}]},"CompanyHistoryStatus":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"status":{"type":"string"}},"required":["status"]}]},"CompanyHistoryIndustry":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"}},"required":["code","text"]}]},"CompanyHistoryEmployee":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"employees":{"type":"string"}},"required":["employees"]}]},"CompanyHistoryForm":{"allOf":[{"$ref":"#/components/schemas/CompanySimpleHistoryEntry"},{"type":"object","properties":{"form":{"type":"string"}},"required":["form"]}]},"CompanyHistory":{"type":"object","properties":{"names":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryName"}},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryAddress"}},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryStatus"}},"industries":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryIndustry"}},"employees":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryEmployee"}},"company_forms":{"type":"array","items":{"$ref":"#/components/schemas/CompanyHistoryForm"}},"secondary_names":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}},"required":["name"]},"description":"Historik over binavne (Standard+)"},"quarterly_employment":{"type":"array","items":{"$ref":"#/components/schemas/QuarterlyEmployment"},"description":"Quarterly employment history (Standard+)"},"monthly_employment":{"type":"array","items":{"$ref":"#/components/schemas/MonthlyEmployment"},"description":"Monthly employment history (Standard+)"},"emails":{"type":"array","items":{"$ref":"#/components/schemas/ContactHistoryEntry"},"description":"Email-historik (Pro+)"},"phones":{"type":"array","items":{"$ref":"#/components/schemas/ContactHistoryEntry"},"description":"Telefon-historik (Pro+)"},"faxes":{"type":"array","items":{"$ref":"#/components/schemas/ContactHistoryEntry"},"description":"Telefax-historik (Pro+)"},"websites":{"type":"array","items":{"$ref":"#/components/schemas/ContactHistoryEntry"},"description":"Webside-historik (Pro+)"},"registration_numbers":{"type":"array","items":{"$ref":"#/components/schemas/RegistrationNumberEntry"},"description":"Historiske registreringsnumre (Pro+)"},"register_entries":{"type":"array","items":{"$ref":"#/components/schemas/ShareholderRegisterEntry"},"description":"Register of owners entries (Basis+ via include=history)"}},"required":["names","addresses","statuses","industries","employees","company_forms"]},"PersonProfileAffiliation":{"type":"object","properties":{"cvr":{"type":"string"},"company_name":{"type":["string","null"]},"company_slug":{"type":"string"},"company_status":{"type":["string","null"],"description":"The company's current CVR status."},"company_status_kind":{"type":"string","enum":["active","in_progress","terminated","unknown"]},"is_active":{"type":"boolean","description":"true when the role is open (left_date is null) and the company does not have a closed CVR status. Use this field instead of checking left_date alone."},"role_title":{"type":["string","null"]},"joined_date":{"type":["string","null"],"format":"date"},"left_date":{"type":["string","null"],"format":"date","description":"Registered end date of the role, capped at the company's known end date. An open role at a closed company gets the company's end date. An earlier end date is kept; an unknown company end date stays null."},"duration_days":{"type":["integer","null"],"description":"Whole days from joined_date to left_date. When left_date is missing and is_active is true, it is measured to today. If the company closed without a left_date, the value is null because the exact end date is unknown. null when joined_date is missing or invalid."},"ownership_share":{"type":["number","null"]},"voting_share":{"type":["number","null"]},"source_type":{"type":"string"},"source_id":{"type":["string","null"]},"confidence":{"type":"number"}},"required":["cvr","company_slug","company_status","company_status_kind","is_active","role_title","source_type","confidence"]},"PersonProfileAlias":{"type":"object","properties":{"alias":{"type":"string"},"normalized_alias":{"type":"string"}},"required":["alias","normalized_alias"]},"PersonProfileResponse":{"type":"object","properties":{"id":{"type":"string"},"canonical_name":{"type":"string"},"slug":{"type":"string"},"normalized_name":{"type":"string"},"match_strategy":{"type":"string"},"match_confidence":{"type":"number"},"aliases":{"type":"array","items":{"type":"string"}},"active_company_count":{"type":"integer","description":"Number of unique companies that are not closed where the person currently has at least one open role. Closed companies count as historical even when the role's left_date is missing."},"historical_company_count":{"type":"integer","description":"Number of unique companies where the person has no active relation. This includes ended roles and roles without left_date at closed companies."},"total_company_count":{"type":"integer","description":"Number of unique CVR numbers in affiliations (active_company_count + historical_company_count)."},"company_count":{"type":"integer","description":"Backwards-compatible alias for total_company_count. Use active_/historical_/total_company_count in new code."},"affiliations":{"type":"array","items":{"$ref":"#/components/schemas/PersonProfileAffiliation"}}},"required":["id","canonical_name","slug","normalized_name","match_strategy","match_confidence","aliases","active_company_count","historical_company_count","total_company_count","company_count","affiliations"]},"PersonSearchHit":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"canonical_name":{"type":"string"},"slug":{"type":"string"},"normalized_name":{"type":"string"},"match_strategy":{"type":"string"},"match_confidence":{"type":"number"},"active_company_count":{"type":"integer","description":"Number of unique companies that are not closed with at least one open role. Closed companies count as historical."},"historical_company_count":{"type":"integer","description":"Number of unique companies where the person only has historical roles. The count describes registered affiliations, not the purpose of the roles."},"total_company_count":{"type":"integer","description":"Total number of unique CVR numbers (active + historical)."},"company_count":{"type":"integer","description":"Bagudkompatibelt alias for total_company_count."},"match_type":{"type":"string","enum":["strong_key","exact","alias","prefix"],"description":"How the query matched this profile. strong_key = numeric query matched a stored enhedsnummer/CVR, exact = normalized name equal, alias = known alias equal, prefix = name or alias begins with query."}},"required":["id","canonical_name","slug","normalized_name","match_strategy","match_confidence","active_company_count","historical_company_count","total_company_count","company_count","match_type"]},"PersonSearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/PersonSearchHit"}},"total":{"type":"integer"},"total_exact":{"type":"boolean","description":"False when the candidate pool was capped and more profiles may match."},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}},"required":["results","total"]},"CompanyRelation":{"type":"object","description":"Direct parent/subsidiary relation inferred from shareholder register entries and legacy owners data. ownership_share, voting_share and control_share are returned as percentages, e.g. 50 = 50%.","properties":{"cvr":{"type":"string"},"name":{"type":"string"},"ownership_share":{"type":["number","null"]},"voting_share":{"type":["number","null"]},"control_share":{"type":["number","null"]},"relation_type":{"type":"string","enum":["parent","subsidiary"]},"inferred":{"type":"boolean"}},"required":["cvr","name","ownership_share","voting_share","control_share","relation_type","inferred"]},"CompanyRelations":{"type":"object","description":"Direct group relations for include=relations. parents are companies controlling the requested company; subsidiaries are companies controlled by the requested company. Relations are inferred from the shareholder register and legacy owners data.","properties":{"parents":{"type":"array","items":{"$ref":"#/components/schemas/CompanyRelation"}},"subsidiaries":{"type":"array","items":{"$ref":"#/components/schemas/CompanyRelation"}}},"required":["parents","subsidiaries"]},"UltimateOwnersShareRange":{"type":"object","description":"Percentage range (0-100). The CVR register records legal owners' shares as intervals, so min and max can differ. Unknown shares count as 0-100.","properties":{"min":{"type":"number"},"max":{"type":"number"}},"required":["min","max"]},"UltimateOwnersPath":{"type":"object","description":"One ownership path from the company up to the person or the end of the branch.","properties":{"depth":{"type":"integer"},"chain":{"type":"array","items":{"type":"object","properties":{"cvr":{"type":["string","null"]},"enhedsnummer":{"type":["string","null"]},"name":{"type":"string"},"ownership_percent":{"oneOf":[{"$ref":"#/components/schemas/UltimateOwnersShareRange"},{"type":"null"}]}},"required":["cvr","enhedsnummer","name","ownership_percent"]}}},"required":["depth","chain"]},"UltimateOwnerPerson":{"type":"object","description":"Natural person found in the ownership chain, with the calculated effective share summed over all branches.","properties":{"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]},"effective_ownership_percent":{"$ref":"#/components/schemas/UltimateOwnersShareRange"},"effective_voting_percent":{"$ref":"#/components/schemas/UltimateOwnersShareRange"},"is_interval":{"type":"boolean"},"has_unknown_shares":{"type":"boolean"},"meets_threshold":{"type":"boolean","description":"True when the minimum ownership share or voting share is at least threshold_percent (25)."},"threshold_status":{"type":"string","enum":["met","possible","not_met"]},"min_chain_depth":{"type":"integer"},"max_chain_depth":{"type":"integer"},"path_count":{"type":"integer"},"paths":{"type":"array","items":{"$ref":"#/components/schemas/UltimateOwnersPath"}}},"required":["name","enhedsnummer","effective_ownership_percent","effective_voting_percent","is_interval","has_unknown_shares","meets_threshold","threshold_status","min_chain_depth","max_chain_depth","path_count","paths"]},"UltimateOwnersUnresolved":{"type":"object","description":"Branch that does not end in an identified natural person.","properties":{"name":{"type":"string"},"cvr":{"type":["string","null"]},"enhedsnummer":{"type":["string","null"]},"entity_type":{"type":["string","null"]},"reason":{"type":"string","enum":["foreign_owner","unidentified_company","company_not_available","no_registered_owners","max_depth","node_limit","path_limit"]},"reason_text":{"type":"string"},"further_owner_unknown":{"type":"boolean"},"effective_ownership_percent":{"$ref":"#/components/schemas/UltimateOwnersShareRange"},"effective_voting_percent":{"$ref":"#/components/schemas/UltimateOwnersShareRange"},"is_interval":{"type":"boolean"},"has_unknown_shares":{"type":"boolean"},"min_chain_depth":{"type":"integer"},"path_count":{"type":"integer"},"paths":{"type":"array","items":{"$ref":"#/components/schemas/UltimateOwnersPath"}}},"required":["name","cvr","reason","reason_text","further_owner_unknown","effective_ownership_percent"]},"UltimateOwners":{"type":["object","null"],"description":"Calculated ultimate owners for include=ultimate_owners (Professionel+). Calculated by FirmaAPI from the registered legal owners; NOT the Danish Business Authority's (Erhvervsstyrelsen) register of beneficial owners. Effective share = the product of the shares along the chain, summed over branches. Only available via the API and MCP; not shown on the public company pages.","properties":{"cvr":{"type":"string"},"name":{"type":["string","null"]},"method":{"type":"string","enum":["calculated_from_legal_owners"]},"disclaimer":{"type":"string"},"computed_at":{"type":"string","format":"date-time"},"max_depth":{"type":"integer","minimum":1,"maximum":10},"threshold_percent":{"type":"number"},"persons":{"type":"array","items":{"$ref":"#/components/schemas/UltimateOwnerPerson"}},"unresolved":{"type":"array","items":{"$ref":"#/components/schemas/UltimateOwnersUnresolved"}},"cycles":{"type":"array","items":{"type":"object","properties":{"cvrs":{"type":"array","items":{"type":"string"}},"names":{"type":"array","items":{"type":"string"}}}}},"truncated":{"type":"boolean","description":"True when the depth limit, the company limit (500) or the path limit (5,000) was reached. See truncation for details."},"truncation":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["max_depth","node_limit","path_limit"]},"message":{"type":"string"}},"required":["code","message"]}},"paths_omitted":{"type":"boolean"},"unresolved_omitted":{"type":"integer"},"stats":{"type":"object","properties":{"companies_visited":{"type":"integer"},"levels_fetched":{"type":"integer"},"paths_evaluated":{"type":"integer"},"deepest_chain":{"type":"integer"},"node_limit":{"type":"integer"},"duration_ms":{"type":"integer"}}},"cache":{"type":"object","properties":{"status":{"type":"string","enum":["hit","stale","miss"]},"computed_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}}},"required":["cvr","method","disclaimer","max_depth","persons","unresolved","cycles","truncated","truncation"]},"LifecyclePeriod":{"type":"object","description":"One active period of the company. Several periods mean the company ceased and resumed.","properties":{"valid_from":{"type":"string","format":"date","description":"Stiftelse/genoptagelsesdato"},"valid_to":{"type":["string","null"],"format":"date","description":"End date (null = still active)"}},"required":["valid_from","valid_to"]},"MergerEvent":{"type":"object","description":"Merger or demerger registered with the Danish Business Authority.","properties":{"type":{"type":"string","enum":["merger","demerger"],"description":"merger = fusion, demerger = spaltning"},"effective_date":{"type":"string","format":"date","description":"Date the merger or demerger took effect"}},"required":["type","effective_date"]},"CompanyEvent":{"type":"object","description":"Derived event in the company timeline.","properties":{"type":{"type":"string","enum":["founded","dissolved","reopened","merged","demerged"],"description":"Event type"},"occurred_at":{"type":"string","description":"When the event happened"},"description":{"type":"string","description":"Description in Danish"}},"required":["type","occurred_at","description"]},"CompanyFinancialYear":{"type":"object","properties":{"year":{"type":"integer"},"period_start":{"type":"string"},"period_end":{"type":"string"},"report_type":{"type":"string","enum":["annual","quarterly","interim"]},"revenue":{"type":["number","null"]},"cost_of_sales":{"type":["number","null"]},"gross_profit":{"type":["number","null"]},"operating_profit":{"type":["number","null"]},"ebitda":{"type":["number","null"]},"depreciation":{"type":["number","null"]},"profit_before_tax":{"type":["number","null"]},"interest_income":{"type":["number","null"]},"interest_expense":{"type":["number","null"]},"tax_expense":{"type":["number","null"]},"net_profit":{"type":["number","null"]},"equity":{"type":["number","null"]},"total_assets":{"type":["number","null"]},"total_liabilities":{"type":["number","null"]},"current_assets":{"type":["number","null"]},"fixed_assets":{"type":["number","null"]},"current_liabilities":{"type":["number","null"]},"long_term_liabilities":{"type":["number","null"]},"cash":{"type":["number","null"]},"share_capital":{"type":["number","null"]},"currency":{"type":"string","description":"ISO 4217 code of the currency the report is in, e.g. DKK, EUR or USD. All amounts in the period are in this currency."},"report_url":{"type":["string","null"],"description":"Direct URL to the PDF annual report filed with the Danish Business Authority, if available."},"employee_expenses":{"type":["number","null"],"description":"Personaleomkostninger (Standard+)"},"other_operating_expenses":{"type":["number","null"],"description":"Andre eksterne omkostninger (Standard+)"},"average_employees":{"type":["number","null"],"description":"Average number of employees / FTE (Standard+)"},"dividends_paid":{"type":["number","null"],"description":"Dividend paid (Standard+)"},"proposed_dividend":{"type":["number","null"],"description":"Proposed dividend recognised in equity (Standard+)"},"goodwill":{"type":["number","null"],"description":"Goodwill (Standard+)"},"intangible_assets":{"type":["number","null"],"description":"Immaterielle aktiver (Standard+)"},"tangible_assets":{"type":["number","null"],"description":"Materielle aktiver (Standard+)"},"financial_assets":{"type":["number","null"],"description":"Finansielle aktiver (Standard+)"},"inventories":{"type":["number","null"],"description":"Varebeholdninger (Standard+)"},"trade_receivables":{"type":["number","null"],"description":"Trade receivables (Standard+)"},"bank_debt_short":{"type":["number","null"],"description":"Short-term bank debt (Standard+)"},"bank_debt_long":{"type":["number","null"],"description":"Long-term bank debt (Standard+)"},"provisions":{"type":["number","null"],"description":"Hensatte forpligtelser (Standard+)"},"retained_earnings":{"type":["number","null"],"description":"Retained earnings (Standard+)"},"cash_from_operations":{"type":["number","null"],"description":"Cash flow from operations (Professionel+)"},"cash_from_investing":{"type":["number","null"],"description":"Cash flow from investing (Professionel+)"},"cash_from_financing":{"type":["number","null"],"description":"Cash flow from financing (Professionel+)"},"free_cash_flow":{"type":["number","null"],"description":"Frit cash flow = drift + investering (Professionel+)"},"audit_opinion":{"type":["string","null"],"enum":["blank","supplerende_oplysninger","forbehold","afkraeftelse","ingen_paategning",null],"description":"Auditor's opinion (Professionel+). null when not available in XBRL."},"going_concern_flag":{"type":["boolean","null"],"description":"Going concern indication (Professionel+). null when unknown."},"ratios":{"type":"object","description":"Calculated financial ratios (Standard+)","properties":{"profit_margin":{"type":["number","null"],"description":"net_profit / revenue"},"gross_margin":{"type":["number","null"],"description":"gross_profit / revenue"},"ebitda_margin":{"type":["number","null"],"description":"ebitda / revenue"},"return_on_assets":{"type":["number","null"],"description":"net_profit / total_assets"},"return_on_equity":{"type":["number","null"],"description":"net_profit / equity"},"solvency_ratio":{"type":["number","null"],"description":"equity / total_assets"},"current_ratio":{"type":["number","null"],"description":"current_assets / current_liabilities"},"quick_ratio":{"type":["number","null"],"description":"(current_assets - inventories) / current_liabilities"},"debt_to_equity":{"type":["number","null"],"description":"total_liabilities / equity"},"interest_coverage":{"type":["number","null"],"description":"operating_profit / interest_expense"}}},"growth":{"type":"object","description":"Year-over-year change against the previous year (Professionel+)","properties":{"revenue_yoy":{"type":["number","null"],"description":"Revenue change (decimal, e.g. 0.15 = +15%)"},"gross_profit_yoy":{"type":["number","null"],"description":"Gross profit change"},"profit_yoy":{"type":["number","null"],"description":"Profit change"},"equity_yoy":{"type":["number","null"],"description":"Equity change"},"total_assets_yoy":{"type":["number","null"],"description":"Total assets change"}}}},"required":["year","period_start","period_end","revenue","gross_profit","profit_before_tax","net_profit","equity","total_assets","currency"]},"CompanyProductionUnit":{"type":"object","properties":{"cvr":{"type":["string","null"]},"p_number":{"type":"string"},"name":{"type":["string","null"]},"address":{"type":"string"},"zipcode":{"type":"string"},"city":{"type":"string"},"industry_code":{"type":["string","null"]},"industry_text":{"type":["string","null"]},"employees":{"type":["string","null"]}},"required":["p_number","name"]},"GovernanceMember":{"type":"object","properties":{"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]},"cvr":{"type":["string","null"]},"function":{"type":"string","description":"FUNKTION from ERST (e.g. DIREKTØR, BESTYRELSESMEDLEM, STIFTER)"},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"business_address":{"type":["string","null"],"description":"FORRETNINGSADRESSE attribute for the role (e.g. the office address of a lawyer acting as director)"},"person_id":{"type":["string","null"],"format":"uuid","description":"Person profile UUID for GET /api/v1/person/{id}. Only on the Professionel/Enterprise plans. null when the member is a company or no profile matched."}},"required":["name","function"]},"BoardMember":{"type":"object","properties":{"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]},"cvr":{"type":["string","null"]},"function":{"type":"string"},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"business_address":{"type":["string","null"]},"election_method":{"type":["string","null"],"description":"VALGFORM value (e.g. 'generalforsamling', 'medarbejdere i selskabet')"},"person_id":{"type":["string","null"],"format":"uuid","description":"Person profile UUID for GET /api/v1/person/{id}. Only on the Professionel/Enterprise plans. null when the member is a company or no profile matched."}},"required":["name","function"]},"Alternate":{"type":"object","properties":{"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]},"cvr":{"type":["string","null"]},"function":{"type":"string"},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"business_address":{"type":["string","null"]},"alternate_for_enhedsnummer":{"type":["string","null"],"description":"enhedsNummer of the primary participant this alternate replaces"}},"required":["name","function"]},"SustainabilityAuditor":{"type":"object","properties":{"name":{"type":"string"},"enhedsnummer":{"type":["string","null"]},"cvr":{"type":["string","null"]},"joined_date":{"type":["string","null"]},"left_date":{"type":["string","null"]},"business_address":{"type":["string","null"]}},"required":["name"]},"ShareholderRegisterEntry":{"type":"object","description":"Legal owner registered in the company's register of owners (REGISTER main type at ERST). One entry per validity period: historical shares have valid_to set, active ones have valid_to=null. ownership_percentage and voting_percentage are decimals (0.20 = 20%).","properties":{"name":{"type":"string","description":"Owner name (person or company)."},"enhedsnummer":{"type":["string","null"],"description":"ERST's unique identifier for the person or company."},"participant_enhedsnummer":{"type":["string","null"],"description":"Same value as enhedsnummer, using the same field name as owners/auditors/ownership_history."},"enhedstype":{"type":["string","null"],"enum":["PERSON","VIRKSOMHED",null],"description":"Type according to ERST. Use it to show person or company context."},"cvr":{"type":["string","null"],"description":"Danish CVR when the owner is a Danish company."},"participant_cvr":{"type":["string","null"],"description":"Same value as cvr, using the same field name as owners/auditors/ownership_history."},"person_id":{"type":["string","null"],"format":"uuid","description":"PersonProfile UUID for the owner when the owner is a person and a profile matched. Only in Pro+/Enterprise responses."},"ownership_percentage":{"type":["number","null"],"description":"EJERANDEL_PROCENT as a decimal. 0.20 means 20% of the capital."},"voting_percentage":{"type":["number","null"],"description":"EJERANDEL_STEMMERET_PROCENT as a decimal."},"share_class":{"type":["string","null"]},"notification_date":{"type":["string","null"],"description":"Date the ownership was notified (EJERANDEL_MEDDELELSE_DATO)."},"valid_from":{"type":["string","null"],"description":"When the ownership took effect."},"valid_to":{"type":["string","null"],"description":"When the ownership ended. null = still active."}},"required":["name"]},"AuditorOffice":{"type":"object","properties":{"auditor_name":{"type":"string"},"auditor_enhedsnummer":{"type":["string","null"]},"auditor_cvr":{"type":["string","null"]},"address":{"type":["object","null"],"description":"The auditor's office address (same structure as address_full)"},"joined_date":{"type":["string","null"],"format":"date","description":"ISO date (YYYY-MM-DD) when the audit firm relation became valid (gyldigFra). Can be null when ERST has no start date."},"left_date":{"type":["string","null"],"format":"date","description":"ISO date when the relation ended (gyldigTil). null while the audit firm is still active."},"active":{"type":"boolean","description":"Convenience flag: true when left_date is null. The list is sorted with active engagements first, then joined_date DESC, so auditor_offices[0] is the current auditor (if any)."}},"required":["auditor_name","active"]},"QuarterlyEmployment":{"type":"object","properties":{"year":{"type":"integer"},"quarter":{"type":"integer","minimum":1,"maximum":4},"employees":{"type":["integer","null"]},"employees_label":{"type":["string","null"]},"fte":{"type":["number","null"]},"fte_label":{"type":["string","null"]}},"required":["year","quarter"]},"MonthlyEmployment":{"type":"object","properties":{"year":{"type":"integer"},"month":{"type":"integer","minimum":1,"maximum":12},"employees":{"type":["integer","null"]},"employees_label":{"type":["string","null"]},"fte":{"type":["number","null"]},"fte_label":{"type":["string","null"]}},"required":["year","month"]},"ContactHistoryEntry":{"type":"object","properties":{"value":{"type":"string"},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]},"ad_protected":{"type":"boolean"}},"required":["value","ad_protected"]},"RegistrationNumberEntry":{"type":"object","properties":{"number":{"type":"string"},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}},"required":["number"]},"MunicipalityCatalogNode":{"type":"object","properties":{"code":{"type":"string"},"numeric_code":{"type":"integer"},"name":{"type":"string"}},"required":["code","numeric_code","name"],"example":{"code":"0101","numeric_code":101,"name":"København"}},"MunicipalityCatalogResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MunicipalityCatalogNode"}},"meta":{"type":"object","properties":{"total":{"type":"integer"}},"required":["total"]}},"required":["items","meta"],"example":{"items":[{"code":"0101","numeric_code":101,"name":"København"},{"code":"0147","numeric_code":147,"name":"Frederiksberg"}],"meta":{"total":99}}},"IndustryCatalogNode":{"type":"object","properties":{"code":{"type":"string","description":"Observed CVR industry code or prefix. Does not identify a DB07/DB25 classification version."},"display_code":{"type":"string"},"label":{"type":"string","description":"Derived from observed CVR descriptions. Parent labels summarize descendants, not official classification headings."},"level":{"type":"string","enum":["division","group","class","branch"]},"parent_code":{"type":["string","null"]},"company_count":{"type":"integer"},"primary_company_count":{"type":"integer"},"secondary_company_count":{"type":"integer"},"child_count":{"type":"integer"}},"required":["code","display_code","label","level","parent_code","company_count","primary_company_count","secondary_company_count","child_count"],"example":{"code":"011110","display_code":"01.11.10","label":"Dyrkning af korn (undtagen ris), bælgfrugter og olieholdige frø","level":"branch","parent_code":"0111","company_count":125,"primary_company_count":94,"secondary_company_count":31,"child_count":0}},"IndustryCatalogMeta":{"type":"object","properties":{"total":{"type":"integer"},"refreshed_at":{"type":"string","format":"date-time"}},"required":["total","refreshed_at"],"example":{"total":2,"refreshed_at":"2026-03-25T12:00:00.000Z"}},"IndustryCatalogResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/IndustryCatalogNode"}},"meta":{"$ref":"#/components/schemas/IndustryCatalogMeta"}},"required":["items","meta"],"example":{"items":[{"code":"011110","display_code":"01.11.10","label":"Dyrkning af korn (undtagen ris), bælgfrugter og olieholdige frø","level":"branch","parent_code":"0111","company_count":125,"primary_company_count":94,"secondary_company_count":31,"child_count":0},{"code":"012100","display_code":"01.21.00","label":"Dyrkning af druer","level":"branch","parent_code":"0121","company_count":53,"primary_company_count":41,"secondary_company_count":12,"child_count":0}],"meta":{"total":2,"refreshed_at":"2026-03-25T12:00:00.000Z"}}},"CompanyResponseDetails":{"type":"object","properties":{"status":{"type":"string"},"company_type":{"type":["string","null"]},"industry_code":{"type":["string","null"]},"industry_text":{"type":["string","null"]},"founded":{"type":["string","null"]},"employees":{"type":["string","null"]},"phone":{"type":["string","null"]},"email":{"type":["string","null"]},"website":{"type":["string","null"]},"municipality_code":{"type":["integer","null"]},"municipality_name":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"all_emails":{"type":"array","items":{"type":"string"}},"all_phones":{"type":"array","items":{"type":"string"}},"fax":{"type":["string","null"]},"audit_form":{"type":["string","null"]},"fiscal_year_start":{"type":["string","null"]},"ad_protected":{"type":"boolean"},"purpose":{"type":["string","null"],"description":"The company's purpose (FORMAAL)"},"secondary_names":{"type":"array","items":{"type":"string"},"description":"Aktive binavne (BINAVN)"},"fiscal_year_end":{"type":["string","null"],"description":"Fiscal year end (MM-DD)"},"first_fiscal_period_end":{"type":["string","null"],"description":"End date of the first fiscal period (Standard+)"},"accounting_class":{"type":["string","null"],"enum":["A","B","C","D",null],"description":"Accounting class (A/B/C/D)"},"employer_registration_date":{"type":["string","null"],"description":"First employer registration (Standard+)"},"vat_registration_date":{"type":["string","null"],"description":"First VAT registration (Standard+)"},"import_registered":{"type":"boolean","description":"Aktiv importregistrering (Standard+)"},"export_registered":{"type":"boolean","description":"Aktiv eksportregistrering (Standard+)"},"excise_registrations":{"type":"array","items":{"type":"string"},"description":"Aktive punktafgiftsregistreringer (Standard+)"},"annual_employees":{"type":["string","null"],"description":"Annual employment (FTE interval) from ERST"},"capital":{"type":["number","null"]},"capital_currency":{"type":["string","null"]},"signing_rule":{"type":["string","null"]},"production_unit_count":{"type":"integer"},"secondary_industries":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"}},"required":["code","text"]}},"secondary_industry_history":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"text":{"type":"string"},"valid_from":{"type":["string","null"]},"valid_to":{"type":["string","null"]}},"required":["code","text"]}},"owners":{"type":"array","description":"Legacy field kept for backwards compatibility. Prefer history.register_entries for legal owners and executives/board_members for management.","deprecated":true,"items":{"$ref":"#/components/schemas/CompanyOwner"}},"auditors":{"type":"array","items":{"$ref":"#/components/schemas/CompanyAuditor"}},"ownership_history":{"type":"array","items":{"$ref":"#/components/schemas/CompanyOwnershipHistoryEntry"}},"history":{"$ref":"#/components/schemas/CompanyHistory"},"financials":{"type":"array","items":{"$ref":"#/components/schemas/CompanyFinancialYear"}},"has_financials":{"type":"boolean"},"financials_pending":{"type":"boolean"},"years_included":{"type":"string"},"production_units":{"type":"array","items":{"$ref":"#/components/schemas/CompanyProductionUnit"}},"relations":{"$ref":"#/components/schemas/CompanyRelations"},"ultimate_owners":{"$ref":"#/components/schemas/UltimateOwners"},"lifecycle":{"type":"array","description":"The company's active periods (Standard+, via include=events)","items":{"$ref":"#/components/schemas/LifecyclePeriod"}},"mergers":{"type":"array","description":"Mergers and demergers (Standard+, via include=events)","items":{"$ref":"#/components/schemas/MergerEvent"}},"events":{"type":"array","description":"Derived event timeline (Standard+, via include=events)","items":{"$ref":"#/components/schemas/CompanyEvent"}},"is_listed":{"type":["boolean","null"],"description":"Listed company (BØRSNOTERET attribute)"},"has_share_classes":{"type":["boolean","null"],"description":"Whether the company has several share classes (KAPITALKLASSER, Standard+)"},"audit_opted_out":{"type":["boolean","null"],"description":"Revision fravalgt (REVISION_FRAVALGT attribut)"},"subject_to_aml_law":{"type":["boolean","null"],"description":"Covered by the Danish anti-money laundering act (Standard+)"},"articles_last_amended":{"type":["string","null"],"description":"Latest change of articles of association (VEDTÆGT_SENESTE, ISO date, Standard+)"},"dissolution_threat":{"type":["object","null"],"description":"Latest dissolution warning (OPLØSNINGSTRUSSEL_SENESTE, Standard+)","properties":{"date":{"type":"string","description":"ISO date (YYYY-MM-DD)"},"reason":{"type":["string","null"]}},"required":["date"]},"archive_registration_number":{"type":["string","null"],"description":"Arkivregistreringsnummer (ARKIV_REGISTRERINGSNUMMER, Standard+)"},"name_identity":{"type":["string","null"],"description":"Name identity (NAVN_IDENTITET, Standard+)"},"has_pseudo_cvr":{"type":["boolean","null"],"description":"Pseudo CVR flag (PSEUDOCVRNR: whether the company has a pseudo CVR number in the CVR register) (Standard+)"},"address_full":{"type":["object","null"],"description":"Full structured address with all parts (Standard+)","properties":{"street":{"type":["string","null"]},"house_number_from":{"type":["integer","null"]},"house_number_to":{"type":["integer","null"]},"letter_from":{"type":["string","null"]},"letter_to":{"type":["string","null"]},"floor":{"type":["string","null"]},"door":{"type":["string","null"]},"po_box":{"type":["string","null"]},"co_name":{"type":["string","null"]},"zipcode":{"type":["string","null"]},"city":{"type":["string","null"]},"city_supplementary":{"type":["string","null"]},"country_code":{"type":["string","null"]},"freetext":{"type":["string","null"]},"street_code":{"type":["integer","null"]},"municipality_code":{"type":["integer","null"]},"municipality_name":{"type":["string","null"]},"address_id":{"type":["string","null"]},"last_validated":{"type":["string","null"]}}},"executives":{"type":"array","description":"Executive board / directors (Basis+; person_id Pro+ only)","items":{"$ref":"#/components/schemas/GovernanceMember"}},"board_members":{"type":"array","description":"Board and chairs (Basis+; person_id Pro+ only)","items":{"$ref":"#/components/schemas/BoardMember"}},"alternates":{"type":"array","description":"Alternates with a reference to the primary member (Pro+)","items":{"$ref":"#/components/schemas/Alternate"}},"liquidators":{"type":"array","description":"Likvidatorer (Pro+)","items":{"$ref":"#/components/schemas/GovernanceMember"}},"sustainability_auditors":{"type":"array","description":"Sustainability auditors (Pro+)","items":{"$ref":"#/components/schemas/SustainabilityAuditor"}},"unlimited_liability_partners":{"type":"array","description":"Fuldt ansvarlige deltagere (interessenter for I/S, K/S, enkeltmandsvirksomhed) (Pro+)","items":{"$ref":"#/components/schemas/GovernanceMember"}},"founders":{"type":"array","description":"Stiftere (Pro+)","items":{"$ref":"#/components/schemas/GovernanceMember"}},"register_entries":{"type":"array","description":"Register of owners entries with ownership and voting shares (Basis+, via include=history; person_id Pro+ only)","items":{"$ref":"#/components/schemas/ShareholderRegisterEntry"}},"auditor_offices":{"type":"array","description":"Revisorers kontorsteder (Pro+)","items":{"$ref":"#/components/schemas/AuditorOffice"}}},"required":["municipality_code","municipality_name"],"example":{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}},"company_type":"Aktieselskab","industry_code":"212000","industry_text":"Fremstilling af farmaceutiske præparater","founded":"1923-02-01","employees":"50.000+","production_unit_count":5,"has_financials":true,"financials_pending":false,"relations":{"parents":[],"subsidiaries":[]}}},"CompanyResponse":{"allOf":[{"$ref":"#/components/schemas/CompanyBase"},{"$ref":"#/components/schemas/CompanyResponseDetails"},{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/CompanyMeta"}},"required":["meta"]}],"example":{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}},"CompanySearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyResponse"}},"total":{"type":"integer","description":"Matches known so far. Exact when total_exact is true, otherwise a lower bound."},"total_exact":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}},"required":["results","total"],"example":{"results":[{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}],"total":1,"total_exact":true,"limit":10,"offset":0,"has_more":false}},"AdvancedSearchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyResponse"}},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"description":"Pass as cursor to fetch the next page (default sort only). Rows refreshed during pagination are not skipped; the last pages contain rows changed since the first page."},"total":{"type":"integer"},"meta":{"type":"object","description":"Present when the request had query parameters the endpoint does not know. They are ignored, not rejected.","properties":{"ignored_params":{"type":"array","items":{"type":"string"}}}}},"required":["results","limit","offset","has_more"],"example":{"results":[{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}],"limit":1,"offset":0,"has_more":false,"next_cursor":null,"total":1}},"BatchResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/CompanyResponse"}},"errors":{"type":"array","items":{"type":"object","properties":{"cvr":{"type":"string"},"code":{"type":"string","enum":["INVALID_CVR","NOT_FOUND"]},"message":{"type":"string"},"error":{"type":"string","deprecated":true,"description":"Deprecated. Use code and message."}},"required":["cvr","code","message"]}},"not_found":{"type":"array","items":{"type":"string"},"description":"Valid CVR numbers that were not found. They do not count against the quota."},"total":{"type":"integer"},"quota_used":{"type":"integer","description":"Requests charged: one per found company. Duplicates are looked up and charged once."},"duplicates_removed":{"type":"integer"}},"required":["results","errors","total","quota_used"],"example":{"results":[{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}],"errors":[{"cvr":"00000000","code":"NOT_FOUND","message":"No company found with CVR 00000000","error":"Not found"}],"not_found":["00000000"],"total":1,"quota_used":1}},"ProductionUnitResponse":{"allOf":[{"$ref":"#/components/schemas/CompanyProductionUnit"},{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/CompanyMeta"}},"required":["meta"]}],"example":{"cvr":"24257690","p_number":"1000000000","name":"NOVO NORDISK A/S","address":"Novo Allé 1","zipcode":"2880","city":"Bagsværd","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}},"WebhookDeliveryStats":{"type":"object","properties":{"success":{"type":"integer"},"failed":{"type":"integer"},"pending":{"type":"integer"}},"required":["success","failed"],"example":{"success":28,"failed":2,"pending":1}},"WebhookBase":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"}},"filters":{"$ref":"#/components/schemas/WebhookFilters"},"is_active":{"type":"boolean"},"description":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"}},"required":["id","url","event_types","is_active","created_at"],"example":{"id":"3f1c2b4a-1111-4222-8333-444455556666","url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed","company.bankruptcy"],"filters":{"cvr_numbers":["24256790","10007127"]},"is_active":true,"description":"Watchlist","created_at":"2026-03-25T12:00:00.000Z"}},"WebhookListItemResponse":{"allOf":[{"$ref":"#/components/schemas/WebhookBase"},{"type":"object","properties":{"consecutive_failures":{"type":"integer"},"last_delivered_at":{"type":["string","null"],"format":"date-time"},"deliveries_24h":{"$ref":"#/components/schemas/WebhookDeliveryStats"}},"required":["consecutive_failures","last_delivered_at","deliveries_24h"]}],"example":{"id":"3f1c2b4a-1111-4222-8333-444455556666","url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed","company.bankruptcy"],"filters":{"cvr_numbers":["24256790","10007127"]},"is_active":true,"description":"Watchlist","created_at":"2026-03-25T12:00:00.000Z","consecutive_failures":0,"last_delivered_at":"2026-03-25T13:00:00.000Z","deliveries_24h":{"success":28,"failed":2,"pending":1}}},"WebhookCreateResponse":{"allOf":[{"$ref":"#/components/schemas/WebhookBase"},{"type":"object","properties":{"secret":{"type":"string"}},"required":["secret"]}],"example":{"id":"3f1c2b4a-1111-4222-8333-444455556666","url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed","company.bankruptcy"],"filters":{"cvr_numbers":["24256790","10007127"]},"is_active":true,"description":"Watchlist","created_at":"2026-03-25T12:00:00.000Z","secret":"whsec_1234567890abcdef"}},"WebhookDetailResponse":{"allOf":[{"$ref":"#/components/schemas/WebhookListItemResponse"},{"type":"object","properties":{"updated_at":{"type":"string","format":"date-time"}},"required":["updated_at"]}],"example":{"id":"3f1c2b4a-1111-4222-8333-444455556666","url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed","company.bankruptcy"],"filters":{"cvr_numbers":["24256790","10007127"]},"is_active":true,"description":"Watchlist","created_at":"2026-03-25T12:00:00.000Z","consecutive_failures":0,"last_delivered_at":"2026-03-25T13:00:00.000Z","deliveries_24h":{"success":28,"failed":2,"pending":1},"updated_at":"2026-03-25T13:05:00.000Z"}},"WebhookListResponse":{"type":"object","properties":{"webhooks":{"type":"array","items":{"$ref":"#/components/schemas/WebhookListItemResponse"}}},"required":["webhooks"],"example":{"webhooks":[{"id":"3f1c2b4a-1111-4222-8333-444455556666","url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed","company.bankruptcy"],"filters":{"cvr_numbers":["24256790","10007127"]},"is_active":true,"description":"Watchlist","created_at":"2026-03-25T12:00:00.000Z","consecutive_failures":0,"last_delivered_at":"2026-03-25T13:00:00.000Z","deliveries_24h":{"success":28,"failed":2,"pending":1}}]}},"WebhookCreateRequest":{"type":"object","description":"Create a webhook for change events. `event_types` supports `company.status.changed` and `company.bankruptcy` from Standard; all other `company.*` events and `person.*` events require Professionel or Enterprise. To follow specific companies, use the `cvr_numbers` filter (up to 1,000 CVRs, Professionel+). Unknown filter keys are rejected with INVALID_FILTERS.","properties":{"url":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"},"minItems":1,"description":"company.* events: company.created, company.status.changed, company.bankruptcy, company.name.changed, company.address.changed, company.participant.changed, company.financials.published, company.industry.changed, company.type.changed, company.capital.changed, company.merged, company.demerged. person.* events (Professionel+): person.profile.created, person.affiliation.added, person.affiliation.ended, person.role.changed, person.ownership.changed. person.profile.merged can be subscribed to but is not emitted yet (planned)."},"filters":{"$ref":"#/components/schemas/WebhookFilters"},"description":{"type":["string","null"]}},"required":["url","event_types"],"example":{"url":"https://example.com/webhooks/firmaapi","event_types":["company.created","company.status.changed"],"filters":{"industry_codes":["62"],"municipality_codes":[101]},"description":"Updates for selected industries and municipalities"},"examples":{"company":{"summary":"Company events with industry and municipality filters","value":{"url":"https://example.com/webhooks/firmaapi","event_types":["company.created","company.status.changed"],"filters":{"industry_codes":["62"],"municipality_codes":[101]},"description":"Updates for selected industries and municipalities"}},"watchlist":{"summary":"Watchlist of specific companies (cvr_numbers, Professionel+)","value":{"url":"https://example.com/webhooks/firmaapi/watchlist","event_types":["company.status.changed","company.bankruptcy","company.participant.changed"],"filters":{"cvr_numbers":["24256790","10007127"]},"description":"Customer watchlist"}},"person":{"summary":"Person events with a person_ids filter (Professionel+)","value":{"url":"https://example.com/webhooks/firmaapi/persons","event_types":["person.affiliation.added","person.affiliation.ended","person.role.changed","person.ownership.changed"],"filters":{"person_ids":["7d64b6da-8d23-4a1a-8ca4-4e4f1d0c0a11","jens-hansen"]},"description":"Monitor registered person roles"}}}},"WebhookUpdateRequest":{"type":"object","description":"Update the webhook configuration. Use filters to cut down events before they reach your receiver. Send filters: null to remove all filters.","properties":{"url":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"},"minItems":1},"filters":{"$ref":"#/components/schemas/WebhookFilters"},"description":{"type":["string","null"]},"is_active":{"type":"boolean"}},"example":{"url":"https://example.com/webhooks/firmaapi","event_types":["company.status.changed"],"filters":{"industry_codes":["6201","6202"]},"description":"Updated companies in selected industries","is_active":true}},"WebhookFilters":{"type":["object","null"],"additionalProperties":false,"description":"Webhook filters (Professionel+). All filters must match. Unknown keys are rejected with 400 INVALID_FILTERS. Company filters (industry_codes, municipality_codes, cvr_numbers) apply to company.* events; person_ids applies to person.* events.","properties":{"industry_codes":{"type":"array","maxItems":200,"items":{"type":"string","pattern":"^\\d{1,6}$"},"description":"Filter company events on the DB07 industry code. Each entry is a code or prefix (1-6 digits) and matches by prefix, like industry_list on /search/advanced. Events without an industry code never pass this filter."},"municipality_codes":{"type":"array","maxItems":200,"items":{"type":"integer","minimum":1},"description":"Filter company events on the municipality code. Events without a municipality code never pass this filter."},"cvr_numbers":{"type":"array","maxItems":1000,"uniqueItems":true,"items":{"type":"string","pattern":"^\\d{8}$"},"description":"Watchlist: only company events for these CVR numbers are delivered. Up to 1,000 CVRs per webhook; duplicates are removed."},"person_ids":{"type":"array","maxItems":500,"items":{"type":"string","minLength":1,"maxLength":128},"description":"Filter person.* events on person ID (UUID) or slug. Max 500 entries."}}},"PersonWebhookEventPayload":{"type":"object","description":"Envelope format for events of type `person.*`. The outer wrapper (id, type, created_at, data) matches `company.*` events; the `data` object differs as documented below.","properties":{"id":{"type":"string"},"type":{"type":"string","description":"One of person.profile.created, person.affiliation.added, person.affiliation.ended, person.role.changed, person.ownership.changed, person.profile.merged"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"person":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"canonical_name":{"type":"string"}},"required":["id","slug","canonical_name"]},"cvr":{"type":"string"},"company_name":{"type":["string","null"]},"affiliation":{"type":"object","properties":{"source_type":{"type":"string","description":"owners | auditors | ownership_history"},"role_title":{"type":["string","null"]},"joined_date":{"type":["string","null"],"format":"date"},"left_date":{"type":["string","null"],"format":"date"},"ownership_share":{"type":["number","null"]},"voting_share":{"type":["number","null"]},"confidence":{"type":["number","null"]}},"required":["source_type"]},"changes":{"type":["object","null"],"description":"Present on role.changed and ownership.changed. Contains old/new deltas for role_title, ownership_share, voting_share."}},"required":["person","cvr","affiliation"]}},"required":["id","type","created_at","data"],"example":{"id":"evt_xyz789","type":"person.role.changed","created_at":"2026-04-24T08:15:00.000Z","data":{"person":{"id":"7d64b6da-8d23-4a1a-8ca4-4e4f1d0c0a11","slug":"jens-hansen","canonical_name":"Jens Hansen"},"cvr":"12345678","company_name":"Acme ApS","affiliation":{"source_type":"owners","role_title":"Bestyrelsesmedlem","joined_date":"2024-01-01","left_date":null,"ownership_share":60,"voting_share":60,"confidence":0.95},"changes":{"role_title":{"old":"Direktør","new":"Bestyrelsesmedlem"},"ownership_share":{"old":40,"new":60},"voting_share":{"old":40,"new":60}}}}},"WebhookDelivery":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":["string","null"],"format":"uuid","description":"Stable event ID. Redeliveries reuse it, so receivers can deduplicate on it."},"event_type":{"type":"string"},"cvr":{"type":"string"},"status":{"type":"string","enum":["pending","success","failed","skipped"],"description":"pending: queued or waiting for a retry. success: the receiver answered 2xx. failed: all 8 attempts failed (about 45 hours). skipped: suppressed without an HTTP request."},"attempts":{"type":"integer"},"status_code":{"type":["integer","null"]},"error_message":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"delivered_at":{"type":["string","null"],"format":"date-time"},"next_retry_at":{"type":["string","null"],"format":"date-time"},"last_attempt_at":{"type":["string","null"],"format":"date-time"}},"required":["id","event_type","cvr","status","attempts","created_at"],"example":{"id":"8b2f6c1e-2222-4333-8444-555566667777","event_id":"c0ffee00-1111-4222-8333-444455556666","event_type":"company.status.changed","cvr":"24256790","status":"success","attempts":1,"status_code":200,"error_message":null,"created_at":"2026-03-25T13:00:00.000Z","delivered_at":"2026-03-25T13:00:02.000Z","next_retry_at":null,"last_attempt_at":"2026-03-25T13:00:02.000Z"}},"WebhookDeliveriesResponse":{"type":"object","properties":{"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDelivery"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"description":"Pass as ?cursor= to get the next page. null on the last page."}},"required":["deliveries","has_more","next_cursor"],"example":{"deliveries":[{"id":"8b2f6c1e-2222-4333-8444-555566667777","event_id":"c0ffee00-1111-4222-8333-444455556666","event_type":"company.status.changed","cvr":"24256790","status":"success","attempts":1,"status_code":200,"error_message":null,"created_at":"2026-03-25T13:00:00.000Z","delivered_at":"2026-03-25T13:00:02.000Z","next_retry_at":null,"last_attempt_at":"2026-03-25T13:00:02.000Z"}],"has_more":true,"next_cursor":"eyJjIjoiMjAyNi0wMy0yNVQxMzowMDowMC4wMDBaIiwiaSI6IjhiMmY2YzFlLTIyMjItNDMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9"}},"WebhookDeliveryDetailResponse":{"allOf":[{"$ref":"#/components/schemas/WebhookDelivery"},{"type":"object","properties":{"response_body":{"type":["string","null"],"description":"First 500 characters of the receiver's last response."},"request":{"type":"object","description":"The request as it was sent. body is the exact JSON that was signed.","properties":{"url":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object"}}}}}},"required":["request"]}],"example":{"id":"8b2f6c1e-2222-4333-8444-555566667777","event_id":"c0ffee00-1111-4222-8333-444455556666","event_type":"company.status.changed","cvr":"24256790","status":"success","attempts":1,"status_code":200,"error_message":null,"created_at":"2026-03-25T13:00:00.000Z","delivered_at":"2026-03-25T13:00:02.000Z","next_retry_at":null,"last_attempt_at":"2026-03-25T13:00:02.000Z","response_body":"{\"ok\":true}","request":{"url":"https://example.com/webhooks/firmaapi","headers":{"X-FirmaAPI-Event":"company.status.changed","X-FirmaAPI-Delivery":"8b2f6c1e-2222-4333-8444-555566667777"},"body":{"id":"c0ffee00-1111-4222-8333-444455556666","type":"company.status.changed","created_at":"2026-03-25T12:59:58.000Z","data":{"company":{"cvr":"24256790","name":"NOVO NORDISK A/S","status":"Aktiv"},"changes":{"status":{"old":"Aktiv","new":"Under konkurs"}}}}}}},"WebhookRedeliverResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"ID of the new delivery."},"redelivery_of":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending"]},"created_at":{"type":"string","format":"date-time"}},"required":["id","redelivery_of","event_id","status"],"example":{"id":"9d3e7f20-3333-4444-8555-666677778888","redelivery_of":"8b2f6c1e-2222-4333-8444-555566667777","event_id":"c0ffee00-1111-4222-8333-444455556666","event_type":"company.status.changed","status":"pending","created_at":"2026-03-26T08:00:00.000Z"}},"WebhookTestResponse":{"type":"object","description":"Result of the test POST. The URL is validated again before sending and redirects are not followed. Only the status code and at most 200 characters of the response body are returned.","properties":{"success":{"type":"boolean"},"status_code":{"type":["integer","null"]},"response_body":{"type":"string","maxLength":200},"error":{"type":"string","description":"Set when no HTTP response was received (timeout or connection error)."}},"required":["success"],"example":{"success":true,"status_code":200,"response_body":"{\"ok\":true}"}}}},"paths":{"/api/v1/company/{cvr}":{"get":{"summary":"Get company by CVR","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"cvr","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{8}$"}},{"name":"include","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["history","finance","production_units","relations","events","ultimate_owners"]},"minItems":1,"uniqueItems":true},"description":"Comma-separated list of include blocks. Allowed values: history, finance, production_units, relations, events, ultimate_owners. ultimate_owners (Professionel+) is calculated from legal owners and is not the Danish Business Authority's register of beneficial owners.","example":["relations","history"]},{"name":"max_depth","in":"query","required":false,"description":"Only used with include=ultimate_owners: how many levels up the ownership chain to follow (1-10, default 10). Invalid values return 400 INVALID_MAX_DEPTH.","schema":{"type":"integer","minimum":1,"maximum":10,"default":10},"example":10},{"name":"If-None-Match","in":"header","required":false,"description":"ETag from an earlier response. When the data is unchanged the API answers 304 Not Modified, which does not count against the quota. ETags are sent for lookups without include or with include=history/events.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Billing-Counted":{"$ref":"#/components/headers/X-Billing-Counted"},"ETag":{"$ref":"#/components/headers/ETag"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyResponse"},"example":{"cvr":"24257690","name":"NOVO NORDISK A/S","status":"Normal","enhedsnummer":"312108","municipality_code":159,"municipality_name":"Gladsaxe","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}}}},"304":{"description":"Not Modified. The company data is unchanged since the ETag in If-None-Match. Not counted against the quota.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"ETag":{"$ref":"#/components/headers/ETag"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getCompany","tags":["Companies"]}},"/api/v1/person/search":{"get":{"summary":"Search person profiles by name","description":"Search person profiles by name, alias or participant enhedsnummer/CVR. Results are sorted by match type (strong_key, exact, alias, prefix), then by number of companies. active_company_count only counts open roles at companies that are not closed. Requires the Professionel or Enterprise plan.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Search term, at least 2 characters. Names are normalised the same way as stored person profiles (unicode, whitespace, lowercase). A purely numeric query of 7+ digits also matches participant enhedsnummer or CVR via PersonProfileAffiliation.sourceId.","schema":{"type":"string","minLength":2},"example":"lars sandahl"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-50, default 10).","schema":{"type":"integer","minimum":1,"maximum":50},"example":10},{"name":"offset","in":"query","required":false,"description":"Spring de første N resultater over (0-500, default 0). Større værdier giver 400 OFFSET_TOO_LARGE.","schema":{"type":"integer","minimum":0,"maximum":500,"default":0}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Billing-Counted":{"$ref":"#/components/headers/X-Billing-Counted"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonSearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"searchPersons","tags":["Persons"]}},"/api/v1/person/{id}":{"get":{"summary":"Get person profile","description":"Read-only person profile with all affiliations across companies. An affiliation is only active when the role is open and the company does not have a closed CVR status. Use affiliations[].is_active instead of checking left_date alone. Requires the Professionel or Enterprise plan.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Person profile ID (UUID). Person IDs are returned by other endpoints (e.g. the company response) and cannot be derived from a CVR enhedsnummer.","schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonProfileResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getPerson","tags":["Persons"]}},"/api/v1/company/search":{"get":{"summary":"Search companies by name","description":"Status filters accept comma-separated display values (for example Aktiv,Under konkurs) and are applied before the result limit.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"example":"novo nordisk"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"example":"Aktiv"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"example":10},{"name":"offset","in":"query","required":false,"description":"Skip the first N matches (0-100, default 0). Larger values return 400 OFFSET_TOO_LARGE; use /api/v1/search/advanced with cursor pagination for large result sets.","schema":{"type":"integer","minimum":0,"maximum":100,"default":0}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Billing-Counted":{"$ref":"#/components/headers/X-Billing-Counted"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"searchCompanies","tags":["Search"]}},"/api/v1/search/advanced":{"get":{"summary":"Advanced search for companies","description":"Backed by an indexed search projection, so very new company writes may take a short while to appear in search results. Exact totals are opt-in via include_total=true and require counting all matches. Use next_cursor with the default sort for deep pagination. Database statement timeouts return HTTP 503 with error.code SEARCH_TIMEOUT, never a partial result or fabricated total.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Company name (partial match). Use * as wildcard, e.g. 'apple*'. Omit or pass * alone to match all.","schema":{"type":"string"},"example":"novo"},{"name":"city","in":"query","required":false,"schema":{"type":"string"},"example":"Bagsværd"},{"name":"zipcode","in":"query","required":false,"schema":{"type":"string"},"example":"2880"},{"name":"municipality","in":"query","required":false,"schema":{"type":"string"},"example":"København"},{"name":"municipality_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated municipality codes or names (OR match).","example":"101,147,461"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"example":"Hovedstaden"},{"name":"region_list","in":"query","required":false,"schema":{"type":"string"},"example":"Hovedstaden,Midtjylland"},{"name":"industry","in":"query","required":false,"schema":{"type":"string"},"example":"212000"},{"name":"industry_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated DB07 prefixes (OR match).","example":"62,631"},{"name":"industry_exclude","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated DB07 prefixes to exclude.","example":"642"},{"name":"company_type","in":"query","required":false,"schema":{"type":"string"},"description":"Company form. Abbreviations (ApS, A/S, IVS, I/S, K/S, P/S, SMBA, AMBA, FMBA, ENK, PMV) match the exact CVR form; any other value is a case-insensitive partial match on the long form, e.g. \"Anpartsselskab\".","example":"ApS"},{"name":"company_type_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated company forms (OR match). Each value is resolved like company_type.","example":"ApS,A/S"},{"name":"owner_kind","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated kinds of the active direct legal owners (OR match): person, holding, fund, company, foreign (no Danish CVR). This is not the ultimate owner.","example":"holding,fund"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"example":"Aktiv"},{"name":"employees","in":"query","required":false,"schema":{"type":"string"},"description":"Number of employees. Formats: \"5+\" (minimum), \"2-10\" (range), \"42\" (exact), or a CVR code such as \"ANTAL_10_19\"","example":"5+"},{"name":"employees_min","in":"query","required":false,"schema":{"type":"integer"},"example":10},{"name":"employees_max","in":"query","required":false,"schema":{"type":"integer"},"example":50},{"name":"founded_after","in":"query","required":false,"schema":{"type":"string"},"example":"1900-01-01"},{"name":"founded_before","in":"query","required":false,"schema":{"type":"string"},"example":"2026-12-31"},{"name":"founded_year","in":"query","required":false,"schema":{"type":"string"},"example":"2024"},{"name":"founded_year_min","in":"query","required":false,"schema":{"type":"string"},"example":"2020"},{"name":"founded_year_max","in":"query","required":false,"schema":{"type":"string"},"example":"2026"},{"name":"dissolved_after","in":"query","required":false,"schema":{"type":"string"},"example":"2020-01-01"},{"name":"dissolved_before","in":"query","required":false,"schema":{"type":"string"},"example":"2026-12-31"},{"name":"dissolved_year","in":"query","required":false,"schema":{"type":"string"},"example":"2024"},{"name":"dissolved_year_min","in":"query","required":false,"schema":{"type":"string"},"example":"2020"},{"name":"dissolved_year_max","in":"query","required":false,"schema":{"type":"string"},"example":"2026"},{"name":"is_dissolved","in":"query","required":false,"schema":{"type":"string"},"example":"false"},{"name":"age_min","in":"query","required":false,"schema":{"type":"integer"},"example":2},{"name":"age_max","in":"query","required":false,"schema":{"type":"integer"},"example":10},{"name":"ad_protected","in":"query","required":false,"schema":{"type":"string"},"example":"false"},{"name":"has_financials","in":"query","required":false,"schema":{"type":"boolean"},"example":true},{"name":"last_report_year_min","in":"query","required":false,"schema":{"type":"integer"},"example":2023},{"name":"last_report_year_max","in":"query","required":false,"schema":{"type":"integer"},"example":2026},{"name":"revenue_min","in":"query","required":false,"description":"Measured on the latest annual report, in DKK. Reports in another currency are converted at Danmarks Nationalbank's rates.","schema":{"type":"integer"},"example":1000000},{"name":"revenue_max","in":"query","required":false,"description":"Measured on the latest annual report, in DKK. Reports in another currency are converted at Danmarks Nationalbank's rates.","schema":{"type":"integer"},"example":5000000},{"name":"capital_min","in":"query","required":false,"description":"Measured on the latest annual report, in DKK. Reports in another currency are converted at Danmarks Nationalbank's rates.","schema":{"type":"integer"},"example":750000},{"name":"capital_max","in":"query","required":false,"description":"Measured on the latest annual report, in DKK. Reports in another currency are converted at Danmarks Nationalbank's rates.","schema":{"type":"integer"},"example":2500000},{"name":"has_phone","in":"query","required":false,"schema":{"type":"boolean"},"example":true},{"name":"has_email","in":"query","required":false,"schema":{"type":"boolean"},"example":true},{"name":"has_website","in":"query","required":false,"schema":{"type":"boolean"},"example":true},{"name":"updated_after","in":"query","required":false,"schema":{"type":"string"},"example":"2026-01-01T00:00:00Z"},{"name":"updated_before","in":"query","required":false,"schema":{"type":"string"},"example":"2026-12-31T23:59:59Z"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"description":"Cursor pagination requires updated_at:desc. Other sorts return next_cursor: null; paginate with offset instead.","example":"updated_at:desc"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Use next_cursor from a previous default-sort response.","example":"eyJ1cGRhdGVkX2F0IjoiMjAyNi0wMS0wMVQwMDowMDowMC4wMDBaIiwiY3ZyIjoiMjQyNTY3OTAifQ"},{"name":"include_total","in":"query","required":false,"schema":{"type":"string"},"example":"true"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"example":10},{"name":"offset","in":"query","required":false,"description":"Offset pagination (max 10000). Larger values return 400 OFFSET_TOO_LARGE; use cursor instead.","schema":{"type":"integer","minimum":0,"maximum":10000},"example":0}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Billing-Counted":{"$ref":"#/components/headers/X-Billing-Counted"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedSearchResponse"}}}},"400":{"description":"Bad request. Malformed filter values return INVALID_PARAM with param; offset above 10000 returns OFFSET_TOO_LARGE.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"advancedSearch","tags":["Search"]}},"/api/v1/usage":{"get":{"summary":"Quota and usage for the current month","description":"Returns plan, used, limit, remaining, reset_at and daily request counts for the current month (Danish time). This call never counts against the quota and also works with test keys.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Billing-Counted":{"$ref":"#/components/headers/X-Billing-Counted"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getUsage","tags":["Account"]}},"/api/v1/search/net-growth":{"get":{"summary":"Net growth (founded minus dissolved) per time bucket","description":"Returns founded count, dissolved count, and net_growth (founded - dissolved) aggregated per time bucket. Same filter syntax as /search/advanced (industry, municipality, city, employees, etc.). The `status` filter is deliberately ignored because applying status=Aktiv to the dissolved query would yield zero by definition. At least one filter (industry/municipality/from/to) is required.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"granularity","in":"query","required":false,"schema":{"type":"string","enum":["month","quarter","year"],"default":"year"},"example":"year"},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2016-01-01"},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-12-31"},{"name":"industry","in":"query","required":false,"schema":{"type":"string"},"example":"62"},{"name":"municipality","in":"query","required":false,"schema":{"type":"string"},"example":"København"},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"zipcode","in":"query","required":false,"schema":{"type":"string"}},{"name":"company_type","in":"query","required":false,"schema":{"type":"string"},"description":"Same semantics as company_type on /search/advanced.","example":"ApS"},{"name":"company_type_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated company forms (OR match).","example":"ApS,A/S"},{"name":"owner_kind","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated kinds of the active direct legal owners (OR match): person, holding, fund, company, foreign (no Danish CVR). This is not the ultimate owner.","example":"holding,fund"},{"name":"employees","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"granularity":{"type":"string","enum":["month","quarter","year"]},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"bucket_count":{"type":"integer"},"truncated":{"type":"boolean"},"totals":{"type":"object","properties":{"founded":{"type":"integer"},"dissolved":{"type":"integer"},"net_growth":{"type":"integer"}}},"results":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string","example":"2024"},"founded":{"type":"integer","example":1200},"dissolved":{"type":"integer","example":850},"net_growth":{"type":"integer","example":350}}}}}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"companyNetGrowth","tags":["Search"]}},"/api/v1/company/batch":{"post":{"summary":"Batch lookup companies","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cvr_numbers":{"type":"array","minItems":1,"items":{"type":"string"}}},"required":["cvr_numbers"]},"example":{"cvr_numbers":["24256790","24257630"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"batchLookupCompanies","tags":["Companies"]}},"/api/v1/production-unit/{p}":{"get":{"summary":"Get production unit by P-number","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"p","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{10}$"},"example":"1000000000"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductionUnitResponse"},"example":{"cvr":"24257690","p_number":"1000000000","name":"NOVO NORDISK A/S","address":"Novo Allé 1","zipcode":"2880","city":"Bagsværd","meta":{"cached_at":"2026-03-25T12:00:00.000Z","data_age_seconds":3600,"source":"postgres","provenance":{"source":"postgres","resolution_rule":"db_row"}}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"502":{"description":"Bad gateway","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getProductionUnit","tags":["Companies"]}},"/api/v1/industries":{"get":{"summary":"List industry catalog snapshot","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndustryCatalogResponse"},"example":{"items":[{"code":"011110","display_code":"01.11.10","label":"Dyrkning af korn (undtagen ris), bælgfrugter og olieholdige frø","level":"branch","parent_code":"0111","company_count":125,"primary_company_count":94,"secondary_company_count":31,"child_count":0},{"code":"012100","display_code":"01.21.00","label":"Dyrkning af druer","level":"branch","parent_code":"0121","company_count":53,"primary_company_count":41,"secondary_company_count":12,"child_count":0}],"meta":{"total":2,"refreshed_at":"2026-03-25T12:00:00.000Z"}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"listIndustries","tags":["Catalogs"]}},"/api/v1/municipalities":{"get":{"summary":"List municipality catalog","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunicipalityCatalogResponse"},"example":{"items":[{"code":"0101","numeric_code":101,"name":"København"},{"code":"0147","numeric_code":147,"name":"Frederiksberg"}],"meta":{"total":99}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"listMunicipalities","tags":["Catalogs"]}},"/api/v1/regions":{"get":{"summary":"List Danish regions with full municipality membership","description":"Returns the 5 official Danish regions (Hovedstaden, Sjælland, Syddanmark, Midtjylland, Nordjylland) with their full municipality_code membership. Used as lookup for the `region` and `region_list` filters on /api/v1/search/advanced. Source: Danmarks Statistik / regionsinddelingen.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"name":"Hovedstaden","full_name":"Region Hovedstaden","municipality_count":30,"municipalities":[{"numeric_code":101,"name":"København"},{"numeric_code":147,"name":"Frederiksberg"}]}],"meta":{"total":5,"total_municipalities":99,"source":"Danmarks Statistik / regionsinddelingen (5 regioner)"}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"listRegions","tags":["Catalogs"]}},"/api/v1/webhooks":{"get":{"summary":"List webhooks","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookListResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"listWebhooks","tags":["Webhooks"]},"post":{"summary":"Create webhook","description":"Requires Standard+ (company.status.changed and company.bankruptcy) or Professionel+ (all events and filters). Plan limits return 403 PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url. The URL must use HTTPS and resolve to public addresses only. Failed deliveries are retried after 1m, 5m, 30m, 2h, 6h, 12h and 24h (with jitter); after 8 failed attempts in a row the webhook is disabled and the account owner gets an email.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"createWebhook","tags":["Webhooks"]}},"/api/v1/webhooks/{id}":{"get":{"summary":"Get webhook","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDetailResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getWebhook","tags":["Webhooks"]},"patch":{"summary":"Update webhook","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdateRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDetailResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"updateWebhook","tags":["Webhooks"]},"delete":{"summary":"Delete webhook","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No content","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"deleteWebhook","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/deliveries":{"get":{"summary":"List webhook deliveries","description":"Newest first. Paginate with next_cursor. Use the detail route for the payload.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Only deliveries with this status. succeeded matches status=success.","schema":{"type":"string","enum":["failed","succeeded","pending"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"description":"next_cursor from the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveriesResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"listWebhookDeliveries","tags":["Webhooks"]}},"/api/v1/webhooks/{id}/test":{"post":{"summary":"Send test webhook","description":"Sends a signed webhook.test event. The URL is validated again before sending (400 INVALID_URL if it now resolves to a private or reserved address), the connection is pinned to the validated IP and redirects are not followed.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"testWebhook","tags":["Webhooks"]}},"/api/v1/company/{cvr}/employees":{"get":{"summary":"Monthly employee snapshots for a company","description":"Per-CVR monthly employee snapshots collected by FirmaAPI. ERST stopped publishing detailed employment time series around 2019, so the series starts when the snapshot job first ran.","parameters":[{"name":"cvr","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{8}$"}},{"name":"from","in":"query","required":false,"description":"First month (inclusive), YYYY-MM.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"example":"2025-01"},{"name":"to","in":"query","required":false,"description":"Last month (inclusive), YYYY-MM.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"example":"2026-10"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cvr":{"type":"string"},"source":{"type":"string","example":"firmaapi-snapshot"},"note":{"type":"string"},"count":{"type":"integer"},"snapshots":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string","example":"2026-10"},"employees":{"type":["integer","null"]},"employees_min":{"type":["integer","null"]},"employees_max":{"type":["integer","null"]},"employees_label":{"type":["string","null"],"example":"10-19"},"captured_at":{"type":"string","format":"date-time"}}}}},"required":["cvr","count","snapshots"]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getCompanyEmployees","tags":["Companies"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}]}},"/api/v1/search/aggregate":{"get":{"summary":"Count companies grouped by a dimension","description":"Counts companies matching the /search/advanced filters, grouped by group_by. At least one filter is required. Results are cached for 15 minutes.","parameters":[{"name":"group_by","in":"query","required":true,"schema":{"type":"string","enum":["industry","municipality","region","zipcode","zipcode_prefix","company_type","status","founded_year","founded_quarter","founded_month","dissolved_year","dissolved_quarter","dissolved_month","employees_bucket","has_financials"]},"example":"industry"},{"name":"top_n","in":"query","required":false,"description":"Number of groups (default 20, max 200; max 1,200 for zipcode).","schema":{"type":"integer","minimum":1,"maximum":1200,"default":20}},{"name":"industry","in":"query","required":false,"schema":{"type":"string"},"example":"62"},{"name":"industry_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated DB07 prefixes (OR match).","example":"62,631"},{"name":"municipality","in":"query","required":false,"schema":{"type":"string"},"example":"København"},{"name":"municipality_list","in":"query","required":false,"schema":{"type":"string"},"example":"101,147"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"example":"Hovedstaden"},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"zipcode","in":"query","required":false,"schema":{"type":"string"}},{"name":"company_type","in":"query","required":false,"schema":{"type":"string"},"description":"Same semantics as company_type on /search/advanced.","example":"ApS"},{"name":"company_type_list","in":"query","required":false,"schema":{"type":"string"},"example":"ApS,A/S"},{"name":"owner_kind","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated kinds of the active direct legal owners (OR match): person, holding, fund, company, foreign.","example":"holding"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"example":"Aktiv"},{"name":"employees","in":"query","required":false,"schema":{"type":"string"},"example":"10-49"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"group_by":{"type":"string"},"total_matches":{"type":"integer"},"total_groups":{"type":"integer"},"top_n":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"key":{"type":["string","null"],"example":"620100"},"count":{"type":"integer","example":8521}}}}},"required":["group_by","total_matches","results"]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"aggregateCompanies","tags":["Search"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}]}},"/api/v1/search/timeseries":{"get":{"summary":"Companies founded or dissolved per time bucket","description":"Counts companies per day, week, month, quarter or year by founding or dissolution date. Same filters as /search/advanced; at least one filter or from/to is required. At most 600 buckets are returned (truncated=true when cut).","parameters":[{"name":"granularity","in":"query","required":false,"schema":{"type":"string","enum":["day","week","month","quarter","year"],"default":"month"}},{"name":"date_field","in":"query","required":false,"schema":{"type":"string","enum":["founded","dissolved"],"default":"founded"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2024-01-01"},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2025-12-31"},{"name":"industry","in":"query","required":false,"schema":{"type":"string"},"example":"62"},{"name":"industry_list","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated DB07 prefixes (OR match).","example":"62,631"},{"name":"municipality","in":"query","required":false,"schema":{"type":"string"},"example":"København"},{"name":"municipality_list","in":"query","required":false,"schema":{"type":"string"},"example":"101,147"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"example":"Hovedstaden"},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"zipcode","in":"query","required":false,"schema":{"type":"string"}},{"name":"company_type","in":"query","required":false,"schema":{"type":"string"},"description":"Same semantics as company_type on /search/advanced.","example":"ApS"},{"name":"company_type_list","in":"query","required":false,"schema":{"type":"string"},"example":"ApS,A/S"},{"name":"owner_kind","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated kinds of the active direct legal owners (OR match): person, holding, fund, company, foreign.","example":"holding"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"example":"Aktiv"},{"name":"employees","in":"query","required":false,"schema":{"type":"string"},"example":"10-49"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"date_field":{"type":"string","enum":["founded","dissolved"]},"granularity":{"type":"string"},"from":{"type":["string","null"]},"to":{"type":["string","null"]},"total_matches":{"type":"integer"},"bucket_count":{"type":"integer"},"truncated":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":["string","null"],"example":"2025-03"},"count":{"type":"integer","example":412}}}}},"required":["granularity","results"]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"companyTimeseries","tags":["Search"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}]}},"/api/v1/webhooks/{id}/deliveries/{deliveryId}":{"get":{"summary":"Get a webhook delivery with its payload","description":"Returns one delivery including the exact JSON body that was signed and the receiver's last response (first 500 characters).","parameters":[{"name":"id","in":"path","required":true,"description":"Webhook ID (UUID). Other values return 404 NOT_FOUND.","schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"description":"Delivery ID (UUID) from GET /api/v1/webhooks/{id}/deliveries.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryDetailResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"getWebhookDelivery","tags":["Webhooks"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}]}},"/api/v1/webhooks/{id}/deliveries/{deliveryId}/redeliver":{"post":{"summary":"Redeliver a webhook event","description":"Queues the delivery's event again as a new delivery with the same event ID and signature scheme. Returns 409 WEBHOOK_INACTIVE when the webhook is disabled and 409 DELIVERY_PENDING when the event already has a pending delivery for this webhook.","parameters":[{"name":"id","in":"path","required":true,"description":"Webhook ID (UUID). Other values return 404 NOT_FOUND.","schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"description":"Delivery ID (UUID) from GET /api/v1/webhooks/{id}/deliveries.","schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted. The new delivery is queued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRedeliverResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Unauthorized: MISSING_API_KEY, INVALID_API_KEY or API_KEY_EXPIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"403":{"description":"Forbidden. Plan restrictions use PLAN_UPGRADE_REQUIRED with required_plan and upgrade_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"description":"Too many requests: RATE_LIMIT_EXCEEDED or MONTHLY_LIMIT_EXCEEDED (with reset_at). Both include upgrade_url and docs_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"},"X-Quota-Limit":{"$ref":"#/components/headers/X-Quota-Limit"},"X-Quota-Remaining":{"$ref":"#/components/headers/X-Quota-Remaining"},"X-Quota-Reset":{"$ref":"#/components/headers/X-Quota-Reset"},"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}}},"503":{"description":"Service unavailable (MAINTENANCE, SEARCH_TIMEOUT, SEARCH_INDEX_NOT_READY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"operationId":"redeliverWebhookDelivery","tags":["Webhooks"],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}]}}},"tags":[{"name":"Companies","description":"Company lookups by CVR, batch lookups, employees and production units."},{"name":"Search","description":"Name search, advanced search and statistics over the company search index."},{"name":"Persons","description":"Person profiles and person search (Professionel+)."},{"name":"Catalogs","description":"Reference catalogs: industries, municipalities and regions."},{"name":"Webhooks","description":"Webhook management, deliveries and redelivery (Standard+)."},{"name":"Account","description":"Account and usage information for the API key."}]}