> ## 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. # Get research answers for a company > Return your account's AI research questions answered for this company — the API form of the AI columns in the app. Each entry carries the question, its run status, the answers once available, and the sources they were grounded in. Free. These are the standing questions your account has configured; adding a company to [Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) is what runs them for it, and that unlock is billed separately. A company you have not unlocked simply returns an empty list. ## OpenAPI ````yaml /reference/openapi.yaml get /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: get: tags: - Companies summary: Get research answers for a company description: >- Return your account's AI research questions answered for this company — the API form of the AI columns in the app. Each entry carries the question, its run status, the answers once available, and the sources they were grounded in. Free. These are the standing questions your account has configured; adding a company to [Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) is what runs them for it, and that unlock is billed separately. A company you have not unlocked simply returns an empty list. operationId: get-company-research-questions parameters: - description: >- LinkedIn numeric company ID. If you only have a name, domain or LinkedIn URL, resolve it first via [Search for a company](/api-reference/companies/search-for-a-company). in: path name: linkedin_id required: true schema: description: >- LinkedIn numeric company ID. If you only have a name, domain or LinkedIn URL, resolve it first via [Search for a company](/api-reference/companies/search-for-a-company). examples: - '104924588' type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GetCompanyResearchQuestionsResponseDto' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Error security: - apikeyAuth: [] - bearerAuth: [] components: schemas: GetCompanyResearchQuestionsResponseDto: additionalProperties: false properties: questions: description: >- Your account's research questions, answered for this company, in the order they are configured. items: $ref: '#/components/schemas/CompanyResearchQuestionDto' type: - array - 'null' required: - questions 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 CompanyResearchQuestionDto: additionalProperties: false properties: answers: description: >- Answers, present only once the status is COMPLETED. A question can be configured to return several. items: $ref: '#/components/schemas/CompanyResearchAnswerDto' type: - array - 'null' id: description: >- Stable ID of the research question in your account. Use it to map an answer onto a CRM field. examples: - b3c6f5e2-1234-4abc-9def-0123456789ab type: string name: description: The column name you gave this question. examples: - Number of brands type: string question: description: The question as configured on your account. examples: - How many brands does this group manage? type: string status: description: >- One of COMPLETED, PROCESSING, FAILED, NOT_STARTED. NOT_STARTED means the question has never run for this company; unlocking a company starts its research automatically, so this normally resolves on its own. examples: - COMPLETED type: string updated_at: description: When this question last produced an answer for this company. format: date-time type: string required: - id - name - question - status - answers 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 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 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 ````