# List company facts `GET /v0/company-facts` Returns source-attributed observations in bundles paginated by companies. Unknown or unpermitted facts are absent. Observation dates do not establish when real-world activity began. ## Authentication `bearerAuth` (http bearer) — Organisation API key supplied only through the Authorization header. Required scopes: `companies:read`. ## Request ### cURL ```shell curl --request GET \ --url "https://api.luranta.com/v0/company-facts" \ --header "Authorization: Bearer $LURANTA_API_KEY" \ --header "Accept: application/json" \ --get \ --data-urlencode "query=Acme" \ --data-urlencode "countries=GB" \ --data-urlencode "industries=technology-information-services" ``` ### TypeScript ```ts import { Client } from "@luranta/sdk" const client = new Client({ apiKey: process.env.LURANTA_API_KEY!, baseUrl: "https://api.luranta.com", maxRetries: 2, }) const result = await client.companyFacts.list({ query: "Acme", countries: [ "GB", ], industries: [ "technology-information-services", ], }) ``` ### Python ```python import os from luranta import Client client = Client( api_key=os.environ["LURANTA_API_KEY"], base_url="https://api.luranta.com", timeout=30, ) result = client.companyFacts.list({ "query": "Acme", "countries": [ "GB", ], "industries": [ "technology-information-services", ], }) ``` ## Query parameters ### `matchingJobs` `object` · optional · style `deepObject` · explode `true` Explicit facts that must match one published job at the company. Action and target selections match one assertion. - Type: `object` - Description: Explicit facts that must match one published job at the company. Action and target selections match one assertion. - Properties: - `agencyPolicies` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `no_unsolicited_submissions`, `approved_agencies_only`, `agencies_invited`. - `applicationRoutes` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `luranta_hosted`, `employer_external`, `intermediary_external`. - `benefits` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `health_insurance`, `retirement_plan`, `paid_parental_leave`, `paid_time_off`, `learning_budget`, `relocation_assistance`. - `complianceConcepts` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `iso_27001`, `iso_9001`, `soc_2`, `pci_dss`, `fedramp`, `gdpr`, `hipaa`. - `complianceRelationships` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `employer_claim`, `registry_record`, `document_verified`, `job_requirement`, `planned_work`. - `includeUnstated` (optional): - Type: `boolean` - `initiativeActions` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `implement_system`, `migrate_system`, `replace_system`, `evaluate_vendor`, `prepare_audit`, `pursue_certification`. - `initiativeCompliance` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `iso_27001`, `iso_9001`, `soc_2`, `pci_dss`, `fedramp`, `gdpr`, `hipaa`. - `initiativeTools` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `ai-and-machine-learning`, `business-finance-and-erp`, `cloud-infrastructure-and-security`, `collaboration-and-productivity`, `creative-and-design`, `data-and-analytics`, `engineering-cad-and-geospatial`, `healthcare-and-laboratory`, `programming-languages`, `sales-marketing-and-service`, `software-delivery-and-testing`, `software-development`, `developer-tools-and-platforms`, `typescript`, `javascript`, `python`, `go`, `rust`, `c`, `c-plus-plus`, `c-sharp`, `objective-c`, `java`, `kotlin`, `swift`, `ruby`, `php`, `scala`, `dart`, `elixir`, `erlang`, `haskell`, `lua`, `perl`, `r`, `matlab`, `bash`, `powershell`, `react`, `react-native`, `nextjs`, `nodejs`, `angular`, `vuejs`, `svelte`, `remix`, `express`, `nestjs`, `django`, `flask`, `fastapi`, `ruby-on-rails`, `spring`, `laravel`, `dotnet`, `asp-net`, `flutter`, `android`, `ios`, `redux`, `tailwind-css`, `sql`, `postgresql`, `mysql`, `mariadb`, `sqlite`, `oracle-database`, `microsoft-sql-server`, `mongodb`, `redis`, `dynamodb`, `cassandra`, `elasticsearch`, `opensearch`, `bigquery`, `redshift`, `dbt`, `airflow`, `spark`, `flink`, `hadoop`, `trino`, `clickhouse`, `neo4j`, `supabase`, `databricks`, `snowflake`, `kafka`, `pytorch`, `tensorflow`, `numpy`, `pandas`, `scikit-learn`, `jax`, `keras`, `xgboost`, `hugging-face`, `langchain`, `llamaindex`, `mlflow`, `cuda`, `openai-api`, `anthropic-api`, `rag`, `computer-vision`, `nlp`, `llms`, `ai-agents`, `linux`, `git`, `github-actions`, `gitlab-ci`, `jenkins`, `circleci`, `argo-cd`, `kubernetes`, `helm`, `docker`, `ansible`, `terraform`, `pulumi`, `openshift`, `aws`, `gcp`, `azure`, `cloudflare`, `vercel`, `netlify`, `serverless`, `prometheus`, `grafana`, `opentelemetry`, `datadog`, `splunk`, `graphql`, `rest`, `grpc`, `rabbitmq`, `nats`, `websockets`, `vite`, `webpack`, `jest`, `vitest`, `cypress`, `playwright`, `selenium`, `storybook`, `excel`, `microsoft-powerpoint`, `microsoft-word`, `microsoft-outlook`, `microsoft-teams`, `microsoft-sharepoint`, `google-workspace`, `slack`, `notion`, `jira`, `confluence`, `adobe-photoshop`, `adobe-illustrator`, `adobe-indesign`, `adobe-premiere-pro`, `adobe-after-effects`, `adobe-acrobat`, `canva`, `figma`, `blender`, `autodesk-maya`, `final-cut-pro`, `autocad`, `autodesk-revit`, `solidworks`, `catia`, `siemens-nx`, `autodesk-fusion-360`, `sketchup`, `arcgis`, `qgis`, `autodesk-civil-3d`, `ansys`, `labview`, `procore`, `primavera-p6`, `tableau`, `power-bi`, `looker`, `alteryx`, `sas`, `ibm-spss`, `stata`, `minitab`, `sap`, `oracle-erp`, `netsuite`, `microsoft-dynamics-365`, `workday`, `quickbooks`, `xero`, `sage`, `servicenow`, `bloomberg-terminal`, `salesforce`, `hubspot`, `marketo`, `google-ads`, `meta-ads`, `google-analytics`, `zendesk`, `epic`, `oracle-health`, `meditech`, `veeva-vault`, `lims`, `zig`, `gleam`, `julia`, `clojure`, `f-sharp`, `ocaml`, `groovy`, `fortran`, `cobol`, `solidity`, `vhdl`, `verilog`, `assembly`, `abap`, `apex`, `crystal`, `nim`, `visual-basic`, `html5`, `css`, `sass`, `less`, `postcss`, `htmx`, `jquery`, `webassembly`, `deno`, `bun`, `astro`, `nuxt`, `gatsby`, `solidjs`, `qwik`, `ember-js`, `alpine-js`, `lit`, `electron`, `tauri`, `ionic`, `capacitor`, `bootstrap`, `mui`, `ant-design`, `chakra-ui`, `shadcn-ui`, `radix-ui`, `base-ui`, `three-js`, `d3-js`, `tanstack`, `zustand`, `zod`, `rxjs`, `prisma`, `drizzle-orm`, `sqlalchemy`, `hibernate`, `entity-framework`, `mongoose`, `sequelize`, `knex-js`, `phoenix`, `symfony`, `cakephp`, `codeigniter`, `fastify`, `koa`, `hono`, `adonisjs`, `actix`, `qt`, `unity`, `unreal-engine`, `godot`, `expo`, `jetpack-compose`, `swiftui`, `opencv`, `opengl`, `vulkan`, `webrtc`, `github`, `gitlab`, `bitbucket`, `azure-devops`, `apache-maven`, `gradle`, `npm`, `pnpm`, `yarn`, `pip`, `poetry`, `composer`, `nuget`, `cmake`, `bazel`, `nx`, `turborepo`, `babel`, `rollup`, `esbuild`, `swc`, `postman`, `insomnia`, `swagger`, `pytest`, `mocha`, `chai`, `jasmine`, `cucumber`, `k6`, `apache-jmeter`, `pact`, `sonarqube`, `sentry`, `visual-studio-code`, `visual-studio`, `intellij-idea`, `pycharm`, `webstorm`, `android-studio`, `xcode`, `eclipse`, `vim`, `neovim`, `mamp`, `travis-ci`, `teamcity`, `buildkite`, `flux-cd`, `tekton`, `skaffold`, `gnu-make`, `nix`, `github-copilot`, `codex`, `claude-code`, `claude`, `opencode`, `openrouter`, `ollama`, `mistral-ai`, `qwen`, `google-gemini`, `deepseek`, `cursor`, `windsurf`, `v0`, `cohere`, `groq`, `vercel-ai-sdk`, `cloudflare-workers`, `fastly`, `alibaba-cloud`, `apache-cloudstack`, `apache-tomcat`, `wp-engine`, `debian`, `ubuntu`, `red-hat-enterprise-linux`, `centos`, `rocky-linux`, `alpine-linux`, `fedora`, `arch-linux`, `windows-server`, `oracle-cloud`, `ibm-cloud`, `digitalocean`, `heroku`, `fly-io`, `render`, `railway`, `firebase`, `akamai`, `openstack`, `cloud-foundry`, `vmware`, `proxmox`, `nomad`, `consul`, `hashicorp-vault`, `packer`, `istio`, `envoy`, `nginx`, `apache-http-server`, `caddy`, `traefik`, `haproxy`, `okta`, `auth0`, `keycloak`, `snyk`, `trivy`, `owasp`, `burp-suite`, `wireshark`, `metasploit`, `palo-alto-networks`, `fortinet`, `zscaler`, `crowdstrike`, `cisco`, `juniper-networks`, `f5`, `tailscale`, `wireguard`, `kibana`, `logstash`, `grafana-loki`, `new-relic`, `dynatrace`, `pagerduty`, `opsgenie`, `honeycomb`, `planetscale`, `polars`, `duckdb`, `cockroachdb`, `influxdb`, `timescaledb`, `couchdb`, `couchbase`, `singlestore`, `tidb`, `pinecone`, `qdrant`, `weaviate`, `milvus`, `turso`, `apache-hive`, `presto`, `apache-druid`, `apache-beam`, `apache-superset`, `metabase`, `qlik`, `jupyter`, `rstudio`, `plotly`, `scipy`, `matplotlib`, `apache-iceberg`, `fivetran`, `airbyte`, `dagster`, `prefect`, `apache-pulsar`, `activemq`, `mqtt`, `linear`, `clickup`, `workplace`, `asana`, `trello`, `monday-com`, `airtable`, `miro`, `zoom`, `dropbox`, `box`, `microsoft-onedrive`, `basecamp`, `todoist`, `loom`, `smartsheet`, `shortcut`, `mattermost`, `webex`, `zapier`, `n8n`, `make-com`, `uipath`, `microsoft-power-automate`, `microsoft-power-apps`, `microsoft-project`, `google-search-console`, `google-tag-manager`, `semrush`, `ahrefs`, `mailchimp`, `klaviyo`, `braze`, `segment`, `mixpanel`, `amplitude`, `hotjar`, `optimizely`, `contentful`, `sanity`, `wordpress`, `webflow`, `shopify`, `woocommerce`, `magento`, `bigcommerce`, `intercom`, `freshdesk`, `hootsuite`, `pipedrive`, `adobe-analytics`, `drupal`, `joomla`, `ghost`, `squarespace`, `wix`, `prestashop`, `odoo`, `sap-successfactors`, `adp-workforce-now`, `ukg`, `dayforce`, `bamboohr`, `docusign`, `stripe`, `paypal`, `square`, `anaplan`, `workiva`, `sketch`, `framer`, `adobe-xd`, `adobe-lightroom`, `adobe-audition`, `davinci-resolve`, `avid-media-composer`, `pro-tools`, `audacity`, `ableton-live`, `fl-studio`, `cinema-4d`, `affinity-designer`, `affinity-photo`, `inkscape`, `gimp`, `krita`, `coreldraw`, `houdini`, `zbrush`, `mapbox`, `openstreetmap`, `google-earth`, `carto`, `rhino-3d`, `archicad`, `autodesk-inventor`, `altium-designer`, `kicad`, `simulink`, `ros`, `benchling`, `labware`. - `listingRelationships` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `direct_employer`, `recruitment_intermediary`. - `noDegreeRequired` (optional): - Type: `enum` - Constant: `true` - `recruitingPlatforms` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `adp`, `ashby`, `avature`, `dayforce`, `eightfold`, `greenhouse`, `icims`, `jobvite`, `lever`, `oraclecloud`, `pageup`, `personio`, `phenom`, `recruitee`, `successfactors`, `smartrecruiters`, `taleo`, `teamtailor`, `ukg`, `workable`, `workday`. - `technologyOperator` (optional): - Type: `enum` - Available options: `any`, `all`. - `technologyRelationships` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `required_experience`, `preferred_experience`, `explicit_current_use`, `planned_introduction`, `planned_replacement`. - `technologyTools` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `typescript`, `javascript`, `python`, `go`, `rust`, `c`, `c-plus-plus`, `c-sharp`, `objective-c`, `java`, `kotlin`, `swift`, `ruby`, `php`, `scala`, `dart`, `elixir`, `erlang`, `haskell`, `lua`, `perl`, `r`, `matlab`, `bash`, `powershell`, `react`, `react-native`, `nextjs`, `nodejs`, `angular`, `vuejs`, `svelte`, `remix`, `express`, `nestjs`, `django`, `flask`, `fastapi`, `ruby-on-rails`, `spring`, `laravel`, `dotnet`, `asp-net`, `flutter`, `android`, `ios`, `redux`, `tailwind-css`, `sql`, `postgresql`, `mysql`, `mariadb`, `sqlite`, `oracle-database`, `microsoft-sql-server`, `mongodb`, `redis`, `dynamodb`, `cassandra`, `elasticsearch`, `opensearch`, `bigquery`, `redshift`, `dbt`, `airflow`, `spark`, `flink`, `hadoop`, `trino`, `clickhouse`, `neo4j`, `supabase`, `databricks`, `snowflake`, `kafka`, `pytorch`, `tensorflow`, `numpy`, `pandas`, `scikit-learn`, `jax`, `keras`, `xgboost`, `hugging-face`, `langchain`, `llamaindex`, `mlflow`, `cuda`, `openai-api`, `anthropic-api`, `rag`, `computer-vision`, `nlp`, `llms`, `ai-agents`, `linux`, `git`, `github-actions`, `gitlab-ci`, `jenkins`, `circleci`, `argo-cd`, `kubernetes`, `helm`, `docker`, `ansible`, `terraform`, `pulumi`, `openshift`, `aws`, `gcp`, `azure`, `cloudflare`, `vercel`, `netlify`, `serverless`, `prometheus`, `grafana`, `opentelemetry`, `datadog`, `splunk`, `graphql`, `rest`, `grpc`, `rabbitmq`, `nats`, `websockets`, `vite`, `webpack`, `jest`, `vitest`, `cypress`, `playwright`, `selenium`, `storybook`, `excel`, `microsoft-powerpoint`, `microsoft-word`, `microsoft-outlook`, `microsoft-teams`, `microsoft-sharepoint`, `google-workspace`, `slack`, `notion`, `jira`, `confluence`, `adobe-photoshop`, `adobe-illustrator`, `adobe-indesign`, `adobe-premiere-pro`, `adobe-after-effects`, `adobe-acrobat`, `canva`, `figma`, `blender`, `autodesk-maya`, `final-cut-pro`, `autocad`, `autodesk-revit`, `solidworks`, `catia`, `siemens-nx`, `autodesk-fusion-360`, `sketchup`, `arcgis`, `qgis`, `autodesk-civil-3d`, `ansys`, `labview`, `procore`, `primavera-p6`, `tableau`, `power-bi`, `looker`, `alteryx`, `sas`, `ibm-spss`, `stata`, `minitab`, `sap`, `oracle-erp`, `netsuite`, `microsoft-dynamics-365`, `workday`, `quickbooks`, `xero`, `sage`, `servicenow`, `bloomberg-terminal`, `salesforce`, `hubspot`, `marketo`, `google-ads`, `meta-ads`, `google-analytics`, `zendesk`, `epic`, `oracle-health`, `meditech`, `veeva-vault`, `lims`, `zig`, `gleam`, `julia`, `clojure`, `f-sharp`, `ocaml`, `groovy`, `fortran`, `cobol`, `solidity`, `vhdl`, `verilog`, `assembly`, `abap`, `apex`, `crystal`, `nim`, `visual-basic`, `html5`, `css`, `sass`, `less`, `postcss`, `htmx`, `jquery`, `webassembly`, `deno`, `bun`, `astro`, `nuxt`, `gatsby`, `solidjs`, `qwik`, `ember-js`, `alpine-js`, `lit`, `electron`, `tauri`, `ionic`, `capacitor`, `bootstrap`, `mui`, `ant-design`, `chakra-ui`, `shadcn-ui`, `radix-ui`, `base-ui`, `three-js`, `d3-js`, `tanstack`, `zustand`, `zod`, `rxjs`, `prisma`, `drizzle-orm`, `sqlalchemy`, `hibernate`, `entity-framework`, `mongoose`, `sequelize`, `knex-js`, `phoenix`, `symfony`, `cakephp`, `codeigniter`, `fastify`, `koa`, `hono`, `adonisjs`, `actix`, `qt`, `unity`, `unreal-engine`, `godot`, `expo`, `jetpack-compose`, `swiftui`, `opencv`, `opengl`, `vulkan`, `webrtc`, `github`, `gitlab`, `bitbucket`, `azure-devops`, `apache-maven`, `gradle`, `npm`, `pnpm`, `yarn`, `pip`, `poetry`, `composer`, `nuget`, `cmake`, `bazel`, `nx`, `turborepo`, `babel`, `rollup`, `esbuild`, `swc`, `postman`, `insomnia`, `swagger`, `pytest`, `mocha`, `chai`, `jasmine`, `cucumber`, `k6`, `apache-jmeter`, `pact`, `sonarqube`, `sentry`, `visual-studio-code`, `visual-studio`, `intellij-idea`, `pycharm`, `webstorm`, `android-studio`, `xcode`, `eclipse`, `vim`, `neovim`, `mamp`, `travis-ci`, `teamcity`, `buildkite`, `flux-cd`, `tekton`, `skaffold`, `gnu-make`, `nix`, `github-copilot`, `codex`, `claude-code`, `claude`, `opencode`, `openrouter`, `ollama`, `mistral-ai`, `qwen`, `google-gemini`, `deepseek`, `cursor`, `windsurf`, `v0`, `cohere`, `groq`, `vercel-ai-sdk`, `cloudflare-workers`, `fastly`, `alibaba-cloud`, `apache-cloudstack`, `apache-tomcat`, `wp-engine`, `debian`, `ubuntu`, `red-hat-enterprise-linux`, `centos`, `rocky-linux`, `alpine-linux`, `fedora`, `arch-linux`, `windows-server`, `oracle-cloud`, `ibm-cloud`, `digitalocean`, `heroku`, `fly-io`, `render`, `railway`, `firebase`, `akamai`, `openstack`, `cloud-foundry`, `vmware`, `proxmox`, `nomad`, `consul`, `hashicorp-vault`, `packer`, `istio`, `envoy`, `nginx`, `apache-http-server`, `caddy`, `traefik`, `haproxy`, `okta`, `auth0`, `keycloak`, `snyk`, `trivy`, `owasp`, `burp-suite`, `wireshark`, `metasploit`, `palo-alto-networks`, `fortinet`, `zscaler`, `crowdstrike`, `cisco`, `juniper-networks`, `f5`, `tailscale`, `wireguard`, `kibana`, `logstash`, `grafana-loki`, `new-relic`, `dynatrace`, `pagerduty`, `opsgenie`, `honeycomb`, `planetscale`, `polars`, `duckdb`, `cockroachdb`, `influxdb`, `timescaledb`, `couchdb`, `couchbase`, `singlestore`, `tidb`, `pinecone`, `qdrant`, `weaviate`, `milvus`, `turso`, `apache-hive`, `presto`, `apache-druid`, `apache-beam`, `apache-superset`, `metabase`, `qlik`, `jupyter`, `rstudio`, `plotly`, `scipy`, `matplotlib`, `apache-iceberg`, `fivetran`, `airbyte`, `dagster`, `prefect`, `apache-pulsar`, `activemq`, `mqtt`, `linear`, `clickup`, `workplace`, `asana`, `trello`, `monday-com`, `airtable`, `miro`, `zoom`, `dropbox`, `box`, `microsoft-onedrive`, `basecamp`, `todoist`, `loom`, `smartsheet`, `shortcut`, `mattermost`, `webex`, `zapier`, `n8n`, `make-com`, `uipath`, `microsoft-power-automate`, `microsoft-power-apps`, `microsoft-project`, `google-search-console`, `google-tag-manager`, `semrush`, `ahrefs`, `mailchimp`, `klaviyo`, `braze`, `segment`, `mixpanel`, `amplitude`, `hotjar`, `optimizely`, `contentful`, `sanity`, `wordpress`, `webflow`, `shopify`, `woocommerce`, `magento`, `bigcommerce`, `intercom`, `freshdesk`, `hootsuite`, `pipedrive`, `adobe-analytics`, `drupal`, `joomla`, `ghost`, `squarespace`, `wix`, `prestashop`, `odoo`, `sap-successfactors`, `adp-workforce-now`, `ukg`, `dayforce`, `bamboohr`, `docusign`, `stripe`, `paypal`, `square`, `anaplan`, `workiva`, `sketch`, `framer`, `adobe-xd`, `adobe-lightroom`, `adobe-audition`, `davinci-resolve`, `avid-media-composer`, `pro-tools`, `audacity`, `ableton-live`, `fl-studio`, `cinema-4d`, `affinity-designer`, `affinity-photo`, `inkscape`, `gimp`, `krita`, `coreldraw`, `houdini`, `zbrush`, `mapbox`, `openstreetmap`, `google-earth`, `carto`, `rhino-3d`, `archicad`, `autodesk-inventor`, `altium-designer`, `kicad`, `simulink`, `ros`, `benchling`, `labware`. - `workingConditions` (optional): - Type: `enum[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `enum` - Available options: `on_call`, `night_work`, `weekend_work`, `shift_work`, `travel_required`. ### `company` `object` · optional · style `deepObject` · explode `true` Company context. Values within each category use OR; categories combine with AND. Employee bounds must contain the whole disclosed interval. FTE never satisfies an employee-count filter. - Type: `object` - Description: Company context. Values within each category use OR; categories combine with AND. Employee bounds must contain the whole disclosed interval. FTE never satisfies an employee-count filter. - Properties: - `complianceConcepts` (optional): - Type: `enum[]` - Maximum items 7 - Maximum items: `7` - Items: - Type: `enum` - Available options: `iso_27001`, `iso_9001`, `soc_2`, `pci_dss`, `fedramp`, `gdpr`, `hipaa`. - `complianceRelationships` (optional): - Type: `enum[]` - Maximum items 5 - Maximum items: `5` - Items: - Type: `enum` - Available options: `employer_claim`, `registry_record`, `document_verified`, `job_requirement`, `planned_work`. - `employeeSize` (optional): - Type: `enum` - Available options: `0`, `1-10`, `11-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001-plus`. - `financingCurrency` (optional): - Type: `enum` - Available options: `AED`, `AFN`, `ALL`, `AMD`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BBD`, `BDT`, `BHD`, `BIF`, `BMD`, `BND`, `BOB`, `BRL`, `BSD`, `BTN`, `BWP`, `BYN`, `BZD`, `CAD`, `CDF`, `CHF`, `CLP`, `CNY`, `COP`, `CRC`, `CUP`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`, `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HTG`, `HUF`, `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`, `LRD`, `LSL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`, `MNT`, `MOP`, `MRU`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`, `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RON`, `RSD`, `RUB`, `RWF`, `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLE`, `SOS`, `SRD`, `SSP`, `STN`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`, `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYU`, `UZS`, `VES`, `VND`, `VUV`, `WST`, `XAF`, `XCD`, `XCG`, `XOF`, `XPF`, `YER`, `ZAR`, `ZMW`, `ZWG`, `BGN`. - `financingMax` (optional): - Type: `number` - Range 0 1000000000000000 - Maximum: `1000000000000000` - Minimum: `0` - `financingMeaning` (optional): - Type: `enum` - Available options: `round_raised`, `offered`, `sold`, `remaining`, `valuation`, `reported_total_raised`. - `financingMin` (optional): - Type: `number` - Range 0 1000000000000000 - Maximum: `1000000000000000` - Minimum: `0` - `financingTypes` (optional): - Type: `enum[]` - Maximum items 5 - Maximum items: `5` - Items: - Type: `enum` - Available options: `equity`, `debt`, `convertible`, `grant`, `mixed`. - `fundingStages` (optional): - Type: `enum[]` - Maximum items 7 - Maximum items: `7` - Items: - Type: `enum` - Available options: `angel`, `pre_seed`, `seed`, `series_a`, `series_b`, `series_c`, `series_d_plus`. - `includeUnstated` (optional): - Type: `boolean` - `kinds` (optional): - Type: `enum[]` - Maximum items 9 - Maximum items: `9` - Items: - Type: `enum` - Available options: `company`, `brand`, `government`, `education`, `healthcare`, `nonprofit`, `partnership`, `agency`, `other`. - `ownershipStatuses` (optional): - Type: `enum[]` - Maximum items 2 - Maximum items: `2` - Items: - Type: `enum` - Available options: `publicly_traded`, `privately_held`. - `workforceBasis` (optional): - Type: `enum` - Available options: `headcount`, `annual_average_employees`. ### `query` `string` · optional Company-name query using case-insensitive substring and similarity matching. Normalized to Unicode NFC with folded whitespace; 1–200 characters. - Type: `string` - Description: Company-name query using case-insensitive substring and similarity matching. Normalized to Unicode NFC with folded whitespace; 1–200 characters. - Range 1 200 - Examples: `["Acme"]` - Maximum length: `200` - Minimum length: `1` Examples - example-1: `Acme` ### `countries` `enum[]` · optional · style `form` · explode `true` ISO 3166-1 alpha-2 country codes. Companies in any supplied country are returned. - Type: `enum[]` - Description: ISO 3166-1 alpha-2 country codes. Companies in any supplied country are returned. - Maximum items 50 - Default: `[]` - Examples: `[["GB"]]` - Maximum items: `50` - Items: - Type: `enum` - Available options: `AD`, `AE`, `AF`, `AG`, `AI`, `AL`, `AM`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CR`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PS`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SV`, `SX`, `SY`, `SZ`, `TC`, `TD`, `TF`, `TG`, `TH`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `YE`, `YT`, `ZA`, `ZM`, `ZW`. Examples - example-1: `["GB"]` ### `industries` `enum[]` · optional · style `form` · explode `true` Industry sector codes assigned to the company. Companies matching any supplied sector are returned. - Type: `enum[]` - Description: Industry sector codes assigned to the company. Companies matching any supplied sector are returned. - Maximum items 23 - Default: `[]` - Examples: `[["technology-information-services"]]` - Maximum items: `23` - Items: - Type: `enum` - Available options: `agriculture-forestry-fishing`, `mining-natural-resources`, `energy-utilities`, `environmental-waste-services`, `manufacturing`, `fashion-textiles-apparel`, `consumer-goods`, `construction`, `real-estate`, `wholesale-retail`, `transport-logistics-postal`, `hospitality-food-travel`, `media-arts-entertainment`, `technology-information-services`, `telecommunications`, `finance-insurance`, `professional-business-services`, `education`, `healthcare-life-sciences`, `social-care`, `government-public-sector`, `nonprofit-associations`, `personal-household-services`. Examples - example-1: `["technology-information-services"]` ### `sort` `enum` · optional Ordering: name is A–Z; recency is recently updated first. Defaults to name. - Type: `enum` - Available options: `name`, `recency`. ### `paginationToken` `string` · optional Opaque keyset token from meta.nextToken or meta.previousToken. Reuse it with unchanged filters and sort. Expires after 24 hours. - Type: `string` - Description: Opaque keyset token from meta.nextToken or meta.previousToken. Reuse it with unchanged filters and sort. Expires after 24 hours. - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` ## Responses ### 200 A page of source-attributed observation bundles. #### Headers ##### `Luranta-Cost-USD` `string` · optional Credit consumed as a USD decimal string. Present only on successful billable responses. - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` ##### `Luranta-Credit-Balance-USD` `string` · optional Organisation credit remaining after settlement. Present only on successful billable responses. - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` ##### `Luranta-Resources-Returned` `integer` · optional Number of resources returned and charged. Present only on successful billable responses. - Type: `integer` - Range 0 2147483647 - Maximum: `2147483647` - Minimum: `0` ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/json - Type: `object` - Properties: - `data` (required): - Type: `object[]` - Maximum items 50 - Maximum items: `50` - Items: - Type: `object` - Properties: - `companyId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `facts` (required): - Type: `object[]` - Items: - Type: `object` - Properties: - `companyId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `evidence` (required): - Type: `object` - Properties: - `dates` (required): - Type: `object` - Properties: - `observedAt` (required): - Type: `string` - Format date-time · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - Format: `date-time` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$` - `occurredOn` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `publishedOn` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `reportingPeriod` (required): - Type: `object` - anyOf: - Type: `object` - Properties: - `end` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - `start` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `digest` (required): - Type: `string` - Pattern ^[0-9a-f]{64}$ - Pattern: `^[0-9a-f]{64}$` - `parserRevision` (required): - Type: `string` - Pattern ^[0-9a-f]{64}$ - Pattern: `^[0-9a-f]{64}$` - `reference` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `sourceUrl` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `fact` (required): - Type: `object` - oneOf: - Type: `object` - Properties: - `asOf` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `basis` (required): - Type: `enum` - Available options: `headcount`, `annual_average_employees`, `full_time_equivalents`. - `kind` (required): - Type: `enum` - Constant: `workforce` - `reportingPeriod` (required): - Type: `object` - anyOf: - Type: `object` - Properties: - `end` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - `start` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `object` - Properties: - `max` (required): - Type: `number` - anyOf: - Type: `number` - Range 0 100000000 - Maximum: `100000000` - Minimum: `0` - Type: `null` - `min` (required): - Type: `number` - anyOf: - Type: `number` - Range 0 100000000 - Maximum: `100000000` - Minimum: `0` - Type: `null` - Type: `object` - Properties: - `amounts` (required): - Type: `object[]` - Maximum items 20 - Maximum items: `20` - Items: - Type: `object` - Properties: - `currency` (required): - Type: `enum` - Available options: `AED`, `AFN`, `ALL`, `AMD`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BBD`, `BDT`, `BHD`, `BIF`, `BMD`, `BND`, `BOB`, `BRL`, `BSD`, `BTN`, `BWP`, `BYN`, `BZD`, `CAD`, `CDF`, `CHF`, `CLP`, `CNY`, `COP`, `CRC`, `CUP`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`, `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HTG`, `HUF`, `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`, `LRD`, `LSL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`, `MNT`, `MOP`, `MRU`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`, `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RON`, `RSD`, `RUB`, `RWF`, `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLE`, `SOS`, `SRD`, `SSP`, `STN`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`, `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYU`, `UZS`, `VES`, `VND`, `VUV`, `WST`, `XAF`, `XCD`, `XCG`, `XOF`, `XPF`, `YER`, `ZAR`, `ZMW`, `ZWG`, `BGN`. - `meaning` (required): - Type: `enum` - Available options: `round_raised`, `offered`, `sold`, `remaining`, `valuation`, `reported_total_raised`. - `value` (required): - Type: `number` - Range 0 1000000000000000 - Maximum: `1000000000000000` - Minimum: `0` - `financingType` (required): - Type: `string` - anyOf: - Type: `enum` - Available options: `equity`, `debt`, `convertible`, `grant`, `mixed`. - Type: `null` - `kind` (required): - Type: `enum` - Constant: `financing` - `occurredOn` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `stage` (required): - Type: `string` - anyOf: - Type: `enum` - Available options: `angel`, `pre_seed`, `seed`, `series_a`, `series_b`, `series_c`, `series_d_plus`. - Type: `null` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - Type: `object` - Properties: - `appliesTo` (required): - Type: `enum` - Available options: `organisation`, `product`, `service`, `facility`, `job`. - `concept` (required): - Type: `enum` - Available options: `iso_27001`, `iso_9001`, `soc_2`, `pci_dss`, `fedramp`, `gdpr`, `hipaa`. - `kind` (required): - Type: `enum` - Constant: `compliance` - `relationship` (required): - Type: `enum` - Available options: `employer_claim`, `registry_record`, `document_verified`, `job_requirement`, `planned_work`. - `soc2ReportType` (required): - Type: `string` - anyOf: - Type: `enum` - Available options: `type_i`, `type_ii`. - Type: `null` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `validFrom` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `validThrough` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `verificationUrl` (required): - Type: `string` - anyOf: - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - Type: `null` - Type: `object` - Properties: - `kind` (required): - Type: `enum` - Constant: `ownership_status` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `enum` - Available options: `publicly_traded`, `privately_held`. - Type: `object` - Properties: - `kind` (required): - Type: `enum` - Constant: `business_audience` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `enum` - Available options: `businesses`, `consumers`, `public_sector`. - Type: `object` - Properties: - `asOf` (required): - Type: `string` - anyOf: - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `null` - `kind` (required): - Type: `enum` - Constant: `legal_status` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `enum` - Available options: `active`, `dissolved`. - Type: `object` - Properties: - `kind` (required): - Type: `enum` - Constant: `founded_on` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - Type: `object` - Properties: - `kind` (required): - Type: `enum` - Constant: `incorporated_on` - `subjectScope` (required): - Type: `enum` - Available options: `hiring_organisation`, `consolidated_hiring_group`, `legal_entity`, `local_establishment`, `parent_organisation`. - `value` (required): - Type: `string` - Format date · Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ - Format: `date` - Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` - `meta` (required): - Type: `object` - Properties: - `nextToken` (required): - Type: `string` - anyOf: - Type: `string` - Maximum length 1000 - Maximum length: `1000` - Type: `null` - `previousToken` (required): - Type: `string` - anyOf: - Type: `string` - Maximum length 1000 - Maximum length: `1000` - Type: `null` - `resultCount` (required): - Type: `integer` - Range 0 50 - Maximum: `50` - Minimum: `0` ### 400 The request contains an invalid parameter, parameter combination, or cursor. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Invalid request ```json { "code": "invalid_request", "detail": "The query cannot be processed as a whole, including conflicting ranges.", "errors": [ { "code": "invalid_request", "message": "The query cannot be processed as a whole, including conflicting ranges.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": false, "status": 400, "title": "Invalid request", "type": "https://docs.luranta.com/errors/invalid-request" } ``` ### 401 The organisation API key is missing, invalid, expired, or revoked. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Invalid API key ```json { "code": "invalid_api_key", "detail": "The Authorization Bearer token is missing, malformed, expired, or revoked.", "errors": [ { "code": "invalid_api_key", "message": "The Authorization Bearer token is missing, malformed, expired, or revoked.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": false, "status": 401, "title": "Invalid API key", "type": "https://docs.luranta.com/errors/invalid-api-key" } ``` ### 402 The organisation does not have enough credit to reserve this operation. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Insufficient credits ```json { "availableCreditUsd": "0.000000", "code": "insufficient_credits", "detail": "The organisation wallet cannot fund the maximum resources requested.", "errors": [ { "code": "insufficient_credits", "message": "The organisation wallet cannot fund the maximum resources requested.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "requiredCreditUsd": "0.020000", "retryable": false, "status": 402, "title": "Insufficient credits", "topUpUrl": "https://luranta.com/settings", "type": "https://docs.luranta.com/errors/insufficient-credits" } ``` ### 403 The authenticated organisation lacks the required scope, or the browser origin is not allowed. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Insufficient scope ```json { "code": "insufficient_scope", "detail": "The credential does not grant the scope required by the operation.", "errors": [ { "code": "insufficient_scope", "message": "The credential does not grant the scope required by the operation.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": false, "status": 403, "title": "Insufficient scope", "type": "https://docs.luranta.com/errors/insufficient-scope" } ``` ### 404 The requested resource does not exist or is not available to this organisation. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Not found ```json { "code": "not_found", "detail": "The requested job or company does not exist or is not commercially available.", "errors": [ { "code": "not_found", "message": "The requested job or company does not exist or is not commercially available.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": false, "status": 404, "title": "Not found", "type": "https://docs.luranta.com/errors/not-found" } ``` ### 408 The server did not complete the request in time. This failure is non-billable and may be retried. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `Retry-After` `integer` · optional Minimum number of seconds before retrying when supplied. - Type: `integer` - Range 0 2147483647 - Maximum: `2147483647` - Minimum: `0` ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Invalid request ```json { "code": "invalid_request", "detail": "The query cannot be processed as a whole, including conflicting ranges.", "errors": [ { "code": "invalid_request", "message": "The query cannot be processed as a whole, including conflicting ranges.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": false, "status": 400, "title": "Invalid request", "type": "https://docs.luranta.com/errors/invalid-request" } ``` ### 429 The organisation request rate was exceeded. Retry after the indicated delay. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `Retry-After` `integer` · optional Minimum number of seconds before retrying when supplied. - Type: `integer` - Range 0 2147483647 - Maximum: `2147483647` - Minimum: `0` ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Rate limit exceeded ```json { "code": "rate_limit_exceeded", "detail": "The organisation exceeded its shared request rate. Honour Retry-After.", "errors": [ { "code": "rate_limit_exceeded", "message": "The organisation exceeded its shared request rate. Honour Retry-After.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": true, "status": 429, "title": "Rate limit exceeded", "type": "https://docs.luranta.com/errors/rate-limit-exceeded" } ``` ### 503 The service or durable usage settlement is temporarily unavailable. This failure is non-billable. This response uses [Problem Details](/reference/problem-details). #### Headers ##### `Retry-After` `integer` · optional Minimum number of seconds before retrying when supplied. - Type: `integer` - Range 0 2147483647 - Maximum: `2147483647` - Minimum: `0` ##### `traceparent` `string` · required W3C trace context generated for this request attempt. - Type: `string` - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$ - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$` ##### `X-Request-Id` `string` · required Unique UUIDv7 identifier for this request attempt. - Type: `string` - Format uuid - Format: `uuid` #### application/problem+json Errors follow [Problem Details](/reference/problem-details). - Type: `object` - Properties: - `availableCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `detail` (required): - Type: `string` - Range 1 1000 - Maximum length: `1000` - Minimum length: `1` - `errors` (required): - Type: `object[]` - Range 1 100 - Maximum items: `100` - Minimum items: `1` - Items: - Type: `object` - Properties: - `code` (required): - Type: `string` - Range 1 80 - Maximum length: `80` - Minimum length: `1` - `message` (required): - Type: `string` - Range 1 500 - Maximum length: `500` - Minimum length: `1` - `pointer` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `instance` (required): - Type: `string` - Format starts_with · Pattern ^\/.* - Format: `starts_with` - Pattern: `^\/.*` - `param` (optional): - Type: `string` - Range 1 160 - Maximum length: `160` - Minimum length: `1` - `requestId` (required): - Type: `string` - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ - Format: `uuid` - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` - `requiredCreditUsd` (optional): - Type: `string` - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$ - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$` - `retryable` (required): - Type: `boolean` - `status` (required): - Type: `integer` - Range 400 599 - Maximum: `599` - Minimum: `400` - `title` (required): - Type: `string` - Range 1 120 - Maximum length: `120` - Minimum length: `1` - `topUpUrl` (optional): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` - `type` (required): - Type: `string` - Format uri · Maximum length 2048 - Format: `uri` - Maximum length: `2048` Example — Service unavailable ```json { "code": "service_unavailable", "detail": "Authentication or the data plane could not complete the request safely.", "errors": [ { "code": "service_unavailable", "message": "Authentication or the data plane could not complete the request safely.", "pointer": "/" } ], "instance": "/v0/company-facts", "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae", "retryable": true, "status": 503, "title": "Service unavailable", "type": "https://docs.luranta.com/errors/service-unavailable" } ``` ## Pagination - Allows page size change: `false` - Cursor ttl seconds: `86400` - Items path: `data` - Next cursor path: `meta.nextToken` - Page size: `50` - Previous cursor path: `meta.previousToken` - Result count path: `meta.resultCount` - Style: `keyset` ## Pricing Estimate the cost of successful list company facts usage. ### Companies - Unit price: `$0.010` - Charging rule: Charged for each company returned by a successful response. | Resources | Estimated cost | | ---: | ---: | | 1,000 | $10.00 | | 10,000 | $100.00 | | 25,000 | $250.00 | | 50,000 | $500.00 | ### Charging metadata - Count path: `data` - Meter: `company_resource` - Model: `returned_resource` - Resource: `company` - Unit price usd: `0.010`