{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Registry & Registration Lookup: Officers, Status",
    "description": "Look up a company in its official business register by name or registration number. Registration number, legal name, status, incorporation date, address, officers where published, licence cited on every record. 40+ jurisdictions. $0.005 a record, $0.003 on higher Apify plans.",
    "version": "0.1",
    "x-build-id": "pFlnLprZBKNStm3am"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pvalyou~company-registry-lookup/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pvalyou-company-registry-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/pvalyou~company-registry-lookup/runs": {
      "post": {
        "operationId": "runs-sync-pvalyou-company-registry-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/pvalyou~company-registry-lookup/run-sync": {
      "post": {
        "operationId": "run-sync-pvalyou-company-registry-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Queries",
            "minItems": 1,
            "type": "array",
            "description": "One lookup per row: a company name or a registration number, and where to look. Pick one register to get its records ($0.005 per matched record), or a region or 'All registers' to search every register in it at once ($0.15 per search, best matches first, at most 50 candidates).",
            "items": {
              "type": "object",
              "properties": {
                "query": {
                  "title": "Company name or registration number",
                  "type": "string",
                  "description": "A legal name (accents and legal-form suffixes are tolerated) or the register's own number in the shape the register uses. The register decides which one it received.",
                  "minLength": 1,
                  "maxLength": 200,
                  "editor": "textfield"
                },
                "jurisdiction": {
                  "title": "Register or region",
                  "type": "string",
                  "description": "A single official register, or a region to search across every register in it. Registers marked 'number only' answer registration numbers alone.",
                  "enum": [
                    "all",
                    "europe",
                    "americas",
                    "asia_pacific",
                    "us",
                    "ar",
                    "au",
                    "be",
                    "br",
                    "bg",
                    "ca",
                    "ca_bc",
                    "cy",
                    "cz",
                    "ee",
                    "fi",
                    "fr",
                    "gr",
                    "in",
                    "ie",
                    "il",
                    "jp",
                    "lv",
                    "lt",
                    "mt",
                    "lei",
                    "no",
                    "pe",
                    "pl",
                    "ro",
                    "rs",
                    "sg",
                    "sk",
                    "si",
                    "se",
                    "ch",
                    "gb",
                    "us_ak",
                    "us_co",
                    "us_ct",
                    "us_dc",
                    "us_fl",
                    "us_ia",
                    "us_ny",
                    "us_or",
                    "us_pa",
                    "us_tx",
                    "us_va"
                  ],
                  "enumTitles": [
                    "All registers (search)",
                    "Europe (search)",
                    "Americas (search)",
                    "Asia Pacific (search)",
                    "United States (search)",
                    "Argentina (Registro Nacional de Sociedades) (name or number)",
                    "Australia (ABN Lookup, Australian Business Register) (name or number)",
                    "Belgium (Crossroads Bank for Enterprises, KBO/BCE) (number only)",
                    "Brazil (Receita Federal CNPJ register via public APIs) (number only)",
                    "Bulgaria (Commercial Register, Registry Agency) (name or number)",
                    "Canada (Canada's Business Registries search: federal, Ontario, Quebec) (name or number)",
                    "Canada, British Columbia (OrgBook BC) (name or number)",
                    "Cyprus (Department of Registrar of Companies open data) (name or number)",
                    "Czech Republic (ARES economic entities) (number only)",
                    "Estonia (e-Business Register open data) (name or number)",
                    "Finland (PRH/YTJ Business Information System open data) (name or number)",
                    "France (Recherche d'entreprises, INSEE Sirene) (name or number)",
                    "Greece (General Commercial Registry, G.E.MI.) (name or number)",
                    "India (Ministry of Corporate Affairs data from public web sources) (number only)",
                    "Ireland (Companies Registration Office open data) (name or number)",
                    "Israel (Registrar of Companies) (name or number)",
                    "Japan (NTA Corporate Number Publication Site) (name or number)",
                    "Latvia (Register of Enterprises open data) (name or number)",
                    "Lithuania (Register of Legal Entities, Registru centras) (name or number)",
                    "Malta (Malta Business Registry open data) (name or number)",
                    "Global (GLEIF Legal Entity Identifier register) (name or number)",
                    "Norway (Bronnoysund Register Centre, Enhetsregisteret) (number only)",
                    "Peru (SUNAT RUC register, padron reducido) (name or number)",
                    "Poland (National Court Register, KRS open API) (number only)",
                    "Romania (ANAF by CUI, ONRC trade register mirror for names) (name or number)",
                    "Serbia (Business Registers Agency, APR) (name or number)",
                    "Singapore (ACRA entities, data.gov.sg) (name only)",
                    "Slovakia (Register of Legal Entities, RPO) (name or number)",
                    "Slovenia (AJPES Business Register, PRS) (name or number)",
                    "Sweden (Bolagsverket, Valuable Datasets API) (number only)",
                    "Switzerland (Zefix central business name index) (name or number)",
                    "United Kingdom (Companies House) (name or number)",
                    "United States, Alaska (Division of Corporations, Business and Professional Licensing) (name or number)",
                    "United States, Colorado (Secretary of State business entities) (name or number)",
                    "United States, Connecticut (Business Registry) (name or number)",
                    "United States, District of Columbia (DLCP corporate registration) (name or number)",
                    "United States, Florida (Division of Corporations, Sunbiz) (name or number)",
                    "United States, Iowa (active business entities open dataset) (name or number)",
                    "United States, New York (Department of State active corporations) (name or number)",
                    "United States, Oregon (Secretary of State active businesses) (name or number)",
                    "United States, Pennsylvania (Department of State current registered businesses) (name or number)",
                    "United States, Texas (Comptroller franchise tax account status) (name or number)",
                    "United States, Virginia (State Corporation Commission) (name or number)"
                  ],
                  "editor": "select"
                }
              },
              "required": [
                "query",
                "jurisdiction"
              ],
              "additionalProperties": false
            }
          },
          "max_candidates": {
            "title": "Maximum candidates",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many shortlist candidates a query may return in total, across every register it searched. Ambiguous names come back as a ranked shortlist rather than a guess.",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}