> ## Documentation Index > Fetch the complete documentation index at: https://docs.captide.ai/llms.txt > Use this file to discover all available pages before exploring further. # Find Companies > Retrieves a list of companies from the Captide database that match user-specified parameters. The response includes key company information such as name, ticker symbol(s) with exchange suffixes, country of domicile, SEC filing status, and the unique company ID assigned by Captide. ## OpenAPI ````yaml GET /api/v2/companies/list openapi: 3.1.0 info: title: Captide REST API description: >- API for accessing financial disclosures and AI-powered financial document analysis. version: 0.3.13 servers: - url: https://rest-api.captide.co description: Prod server security: [] paths: /api/v2/companies/list: get: tags: - Companies summary: List companies description: >- Retrieves a list of companies from the Captide database that match user-specified parameters. The response includes key company information such as name, ticker symbol(s) with exchange suffixes, country of domicile, SEC filing status, and the unique company ID assigned by Captide. operationId: list_companies_api_v2_companies_list_get parameters: - name: tickers in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated list of company tickers (supports both base tickers like 'ITX' and suffixed tickers like 'ITX.MC') examples: - STO.AX,ASML.AS title: Tickers description: >- Comma-separated list of company tickers (supports both base tickers like 'ITX' and suffixed tickers like 'ITX.MC') - name: countries in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated list of companies' country of domicile (ISO 3166-1 alpha-2) examples: - AU,NL title: Countries description: >- Comma-separated list of companies' country of domicile (ISO 3166-1 alpha-2) - name: filesWithSec in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Whether the companies file reports with the SEC examples: - false title: Fileswithsec description: Whether the companies file reports with the SEC - name: ids in: query required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of unique company IDs examples: - >- 77848abe-a215-41b7-8950-86e89ea1fadc,91f6c6da-478f-4161-b451-aa5177cc7fb9 title: Ids description: Comma-separated list of unique company IDs - name: ciks in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated list of Central Index Keys (CIK) assigned by the SEC examples: - 0000320193,0000789019 title: Ciks description: Comma-separated list of Central Index Keys (CIK) assigned by the SEC - name: permids in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated list of PermIDs (Permanent Identifiers) assigned by Refinitiv examples: - 4295907168,4295907169 title: Permids description: >- Comma-separated list of PermIDs (Permanent Identifiers) assigned by Refinitiv - name: limit in: query required: false schema: anyOf: - type: integer maximum: 1000 minimum: 1 - type: 'null' description: Maximum number of records to return examples: - 100 default: 100 title: Limit description: Maximum number of records to return responses: '200': description: Company list retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/CompanyResponse' title: Response List Companies Api V2 Companies List Get examples: companies: summary: Example companies list value: - id: 77848abe-a215-41b7-8950-86e89ea1fadc name: Santos Ltd. tickers: - STO.AX countries: - AU filesWithSec: false permid: '4295857141' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - APIKeyHeader: [] components: schemas: CompanyResponse: properties: id: type: string title: Id description: Unique company ID name: type: string title: Name description: Company name tickers: items: type: string type: array title: Tickers description: >- List of ticker symbols with exchange suffixes (e.g., 'ASML', 'ASML.AS') countries: items: type: string type: array title: Countries description: Company's country of domicile (ISO 3166-1 alpha-2) filesWithSec: type: boolean title: Fileswithsec description: Whether the company files reports with the SEC cik: anyOf: - type: string - type: 'null' title: Cik description: Central Index Key (CIK) assigned by the SEC permid: anyOf: - type: string - type: 'null' title: Permid description: PermID (Permanent Identifier) assigned by Refinitiv type: object required: - id - name - tickers - countries - filesWithSec title: CompanyResponse description: Response model for single company retrieval. ErrorResponse: properties: detail: type: string title: Detail type: object required: - detail title: ErrorResponse description: Standard error response model for all API endpoints. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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: APIKeyHeader: type: apiKey in: header name: X-API-Key ````