> ## 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.

# Search by company number



## OpenAPI

````yaml /api-reference/openapi.json get /v2/search/aheadFull/{companyNumber}
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/search/aheadFull/{companyNumber}:
    get:
      tags:
        - search
      summary: Search by company number
      operationId: 7a2dfc57a45ffc86530428a91012eb75
      parameters:
        - $ref: '#/components/parameters/ApiPathCompanyNumber'
      responses:
        '200':
          description: Type-ahead / search hits from the product API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductApiPassthroughObject'
      security:
        - bearerAuth: []
        - auth:
            - read:search
            - search:aheadFull
components:
  parameters:
    ApiPathCompanyNumber:
      name: companyNumber
      in: path
      description: Companies House company number.
      required: true
      schema:
        type: string
  schemas:
    ProductApiPassthroughObject:
      description: >-
        JSON object returned from the upstream product API with no extra shaping
        by this gateway. Exact properties depend on the operation. Fields may be
        omitted when the token lacks optional scopes (see `config/api.php`
        scope_field_map).
      type: object
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      bearerFormat: JWT
      scheme: bearer

````