> ## Documentation Index > Fetch the complete documentation index at: https://docs.api.tamtam.ai/llms.txt > Use this file to discover all available pages before exploring further. # Ask a research question about a company > Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via [Get an asked research question](/api-reference/companies/get-an-asked-research-question). Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does **not** need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from [Get research answers for a company](/api-reference/companies/get-research-answers-for-a-company), which returns those standing questions rather than one you asked here. ## OpenAPI ````yaml /reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions openapi: 3.1.0 info: title: Tamtam Public API version: 2.0.0 servers: - url: https://api.tamtam.ai/api security: [] paths: /v2/companies/{linkedin_id}/research-questions: post: tags: - Companies summary: Ask a research question about a company description: >- Ask a grounded, free-form research question about one company. Returns immediately with an ID to poll via [Get an asked research question](/api-reference/companies/get-an-asked-research-question). Costs 1 credit per company, the same as a custom AI column: answering runs a model with web search behind it. Asking is idempotent on the question text — re-asking a question you already asked about this company returns the same ID and its existing answer, and is not charged again. Works on any company. The company does **not** need to be in Key Accounts: the credit is the payment, exactly as it is for a custom AI column on a companies list. Unlocking a company buys something different — the bundle of standing questions that then run for it, billed on its own line. Distinct from [Get research answers for a company](/api-reference/companies/get-research-answers-for-a-company), which returns those standing questions rather than one you asked here. operationId: ask-company-research-question parameters: - description: LinkedIn numeric company ID. in: path name: linkedin_id required: true schema: description: LinkedIn numeric company ID. examples: - '104924588' type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/AskCompanyResearchQuestionInputBody' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/AskedResearchQuestionDto' description: Accepted default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Error security: - apikeyAuth: [] - bearerAuth: [] components: schemas: AskCompanyResearchQuestionInputBody: additionalProperties: false properties: answer_count: description: >- How many answers to produce, as an instruction to the model rather than a hard count. Defaults to one. examples: - '1' type: string answer_format: description: >- How the answer should read — 'a single number', 'a short paragraph', 'a bullet list'. Defaults to a detailed answer. examples: - a single number type: string question: description: The question to answer about this company, in plain language. examples: - How many brands does this group manage? maxLength: 2000 minLength: 3 type: string required: - question type: object AskedResearchQuestionDto: additionalProperties: false properties: answers: description: Answers, present once the status is COMPLETED. items: $ref: '#/components/schemas/CompanyResearchAnswerDto' type: - array - 'null' id: description: ID of this asked question. Poll it to collect the answer. examples: - b3c6f5e2-1234-4abc-9def-0123456789ab type: string question: description: The question as asked. examples: - How many brands does this group manage? type: string status: description: One of COMPLETED, PROCESSING, FAILED. examples: - PROCESSING type: string updated_at: description: When this question last produced an answer. format: date-time type: string required: - id - question - status - answers type: object ErrorModel: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object CompanyResearchAnswerDto: additionalProperties: false properties: answer: description: The answer text. examples: - Roughly 30 brands, grouped under four divisions. type: string sources: description: >- URLs the answer was grounded in. Empty when the answer came from context we already held rather than from the web. items: type: string type: - array - 'null' required: - answer - sources type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: apikeyAuth: description: Account API key passed in the Authorization header in: header name: Authorization type: apiKey bearerAuth: description: Bearer JWT obtained via the OAuth 2.1 authorization flow scheme: bearer type: http ````