> ## Documentation Index > Fetch the complete documentation index at: https://docs.registercheck.de/llms.txt > Use this file to discover all available pages before exploring further. # Search Companies > Search endpoint with filtering capabilities This endpoint supports: - Basic company information filtering (name, register number, court, prefix, active status) - Address and location filtering (address, city) - Financial information filtering (has financial reports) The results are paginated with count information included. ## Filter Examples ### Basic company search ``` ?name=Tech&city=Berlin&is_active=true ``` ### Search by register details ``` ?register_number=123456®ister_court=Amtsgericht Berlin®ister_prefix=HRB ``` ### Search with financial filter ``` ?has_financials=true&city=Munich ``` ## OpenAPI ````yaml get /search/companies openapi: 3.1.0 info: title: Registercheck API version: 1.0.0 servers: - url: https://jobs-api.registercheck.de/api/v2 security: [] paths: /search/companies: get: tags: - Search summary: Search Companies description: >- Search endpoint with filtering capabilities This endpoint supports: - Basic company information filtering (name, register number, court, prefix, active status) - Address and location filtering (address, city) - Financial information filtering (has financial reports) The results are paginated with count information included. ## Filter Examples ### Basic company search ``` ?name=Tech&city=Berlin&is_active=true ``` ### Search by register details ``` ?register_number=123456®ister_court=Amtsgericht Berlin®ister_prefix=HRB ``` ### Search with financial filter ``` ?has_financials=true&city=Munich ``` operationId: search_companies_search_companies_get parameters: - name: name in: query required: false schema: anyOf: - type: string - type: 'null' description: Company name (partial match) title: Name description: Company name (partial match) - name: register_number in: query required: false schema: anyOf: - type: string - type: 'null' description: Company register number title: Register Number description: Company register number - name: register_court in: query required: false schema: anyOf: - type: string - type: 'null' title: Register Court description: Court where the company is registered description: Court where the company is registered - name: register_prefix in: query required: false schema: anyOf: - type: string - type: 'null' title: Register Prefix description: Register prefix (e.g., HRB, HRA) description: Register prefix (e.g., HRB, HRA) - name: is_active in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Whether the company is active title: Is Active description: Whether the company is active - name: address in: query required: false schema: anyOf: - type: string - type: 'null' description: Address (partial match) title: Address description: Address (partial match) - name: city in: query required: false schema: anyOf: - type: string - type: 'null' description: City (partial match) title: City description: City (partial match) - name: has_financials in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Whether the company has financial reports title: Has Financials description: Whether the company has financial reports - name: offset in: query required: false schema: type: integer minimum: 0 description: Number of items to skip default: 0 title: Offset description: Number of items to skip - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Maximum number of items to return default: 10 title: Limit description: Maximum number of items to return responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CompanySearchResponse' '400': description: Invalid filters provided '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal server error security: - HTTPBearer: [] components: schemas: CompanySearchResponse: properties: companies: items: $ref: '#/components/schemas/CompanySearchResult' type: array title: Companies description: List of matching companies total_count: type: integer title: Total Count description: Total number of companies found page_count: type: integer title: Page Count description: Number of pages available pagination: $ref: >- #/components/schemas/registercheck_jobs__api__models__search_response__PaginationInfo description: Pagination information for the results type: object required: - companies - total_count - page_count - pagination title: CompanySearchResponse description: Model for company search response HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CompanySearchResult: properties: id: type: string title: Id description: Unique identifier for the company name: type: string title: Name description: Official company name register_number: anyOf: - type: integer - type: 'null' title: Register Number description: Company registration number register_court: anyOf: - type: string - type: 'null' title: Register Court description: Court where the company is registered register_prefix: anyOf: - type: string - type: 'null' title: Register Prefix description: Register prefix (e.g., HRB, HRA) country: anyOf: - type: string - type: 'null' title: Country description: Country code where company is registered legal_form: anyOf: - type: string - type: 'null' title: Legal Form description: Legal form of the company is_active: anyOf: - type: boolean - type: 'null' title: Is Active description: Whether the company is currently active status: anyOf: - type: string - type: 'null' title: Status description: Current status of the company has_financial_reports: anyOf: - type: boolean - type: 'null' title: Has Financial Reports description: Whether company has financial reports type: object required: - id - name title: CompanySearchResult description: Model for company search result registercheck_jobs__api__models__search_response__PaginationInfo: properties: offset: type: integer title: Offset description: Number of results to skip from the beginning limit: type: integer title: Limit description: Maximum number of results to return in this page type: object required: - offset - limit title: PaginationInfo description: Model for pagination information ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http description: Enter your API key scheme: bearer ````