> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thedatacity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check companies exist



## OpenAPI

````yaml /api-reference/openapi.json post /v2/companies/check
openapi: 3.0.0
info:
  title: The Data City API (v2)
  description: API v2. Use these endpoints for new integrations.
  version: 2.0.0
servers:
  - url: https://product-api.thedatacity.com/api
    description: Production
security: []
tags:
  - name: classification
    description: >-
      Classification and ML: classify companies, list summary, explain
      classifier, explain company score.
  - name: companies
    description: >-
      Companies: details, group structure, check, batch, export, filtered
      companies.
  - name: directors
    description: 'Directors: director details by person number.'
  - name: explore
    description: 'Explore lists: filter-based lists by list ID, domain, or email.'
  - name: filters
    description: 'Filters: get available filters and filtered company results.'
  - name: rtics
    description: RTIC details and metadata.
  - name: search
    description: 'Search: ahead full and full-text search.'
  - name: smart-lists
    description: 'User lists (ML): list details by list ID, domain, or email.'
paths:
  /v2/companies/check:
    post:
      tags:
        - companies
      summary: Check companies exist
      operationId: 2a9502a22770f6b39f5f5670dce1d4d3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCheckCompanyNumbersBody'
      responses:
        '200':
          description: Per-number existence flags from the product API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCheckCompaniesResponseBody'
      security:
        - bearerAuth: []
        - auth:
            - read:companies
            - companies:check
components:
  schemas:
    PostCheckCompanyNumbersBody:
      title: Check companies exist
      description: Full shape is under Schema; example is minimal.
      required:
        - companyNumbers
      properties:
        companyNumbers:
          description: JSON body for POST companies check.
          type: array
          items:
            type: string
      type: object
      example:
        companyNumbers:
          - '10958787'
    PostCheckCompaniesResponseBody:
      description: >-
        One row per input company number, in the same order as `companyNumbers`
        in the request.
      type: array
      items:
        $ref: '#/components/schemas/CompanyNumberExistenceRow'
    CompanyNumberExistenceRow:
      description: 'Per company number: whether it exists in the product database.'
      properties:
        CompanyNumber:
          description: Companies House company number as requested.
          type: string
        InDatabase:
          description: True if the company is known to the product API.
          type: boolean
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      bearerFormat: JWT
      scheme: bearer

````