> ## Documentation Index > Fetch the complete documentation index at: https://docs.augment.market/llms.txt > Use this file to discover all available pages before exploring further. # Get a company > Returns a single company by its identifier ## OpenAPI ````yaml /openapi.generated.json get /api/v1/companies/{company_id} openapi: 3.0.3 info: title: Augment External API version: 1.0.0 description: > Public, API-key-authenticated read surface for Augment company and offering data. servers: - url: https://developer.augment.market - url: https://xxe4toqf29.execute-api.us-west-2.amazonaws.com/dev-ethan security: [] paths: /api/v1/companies/{company_id}: get: tags: - external-api-v1 summary: Get a company description: Returns a single company by its identifier operationId: getExternalApiCompany parameters: - name: company_id in: path description: The identifier of the company required: true schema: type: integer responses: '200': description: The requested company content: application/json: schema: $ref: '#/components/schemas/CompanyDetail' example: id: 42 name: Acme Robotics normalized_name: acme-robotics legal_name: Acme Robotics, Inc. domain: acmerobotics.com description: Builds warehouse automation robots. logo_filename: acme-robotics.png logo_color: '#1A73E8' ticker: ACME founded_year: 2015 location: San Francisco, CA categories: - id: 3 slug: robotics name: Robotics research: - id: res_123 title: 'Acme Robotics: Company Overview' document_type: COMPANY link: https://research.augment.market/acme-robotics published_at: '2024-11-01T00:00:00Z' news: - id: 9001 headline: Acme Robotics raises Series C description: Acme Robotics announced a new funding round. published_at: '2024-12-01T00:00:00Z' articles: - id: 5001 headline: Acme Robotics raises Series C summary: The company plans to expand manufacturing. link: https://news.example.com/acme-series-c publication: TechDaily published_at: '2024-12-01T00:00:00Z' created_at: '2024-01-10T00:00:00Z' updated_at: '2025-01-15T12:00:00Z' '400': $ref: '#/components/responses/ErrorBadRequest' '401': $ref: '#/components/responses/ErrorUnauthorized' '403': $ref: '#/components/responses/ErrorForbidden' '404': $ref: '#/components/responses/ErrorNotFound' '429': $ref: '#/components/responses/ErrorRateLimited' '500': $ref: '#/components/responses/ErrorInternalError' '503': $ref: '#/components/responses/ErrorServiceUnavailable' security: - ApiKeyAuth: [] components: schemas: CompanyDetail: type: object description: Full view of a single company properties: id: type: integer description: Company identifier name: type: string description: Company display name normalized_name: type: string description: URL-safe normalized company name legal_name: type: string description: Registered legal name of the company domain: type: string description: Primary web domain of the company description: type: string description: Description of what the company does logo_filename: type: string description: Filename of the company logo asset logo_color: type: string description: Brand colour associated with the company logo ticker: type: string description: Short ticker-style company abbreviation founded_year: type: integer description: Year the company was founded location: type: string description: Headquarters location of the company categories: type: array description: Categories the company belongs to items: $ref: '#/components/schemas/CompanyCategory' research: type: array description: Research documents about the company items: $ref: '#/components/schemas/CompanyResearchItem' news: type: array description: News items about the company items: $ref: '#/components/schemas/CompanyNewsItem' created_at: type: string format: date-time description: When the company record was created updated_at: type: string format: date-time description: When the company record was last updated required: - id - name - normalized_name - legal_name - domain - description - logo_filename - logo_color - ticker - founded_year - location - categories - research - news - created_at - updated_at additionalProperties: false CompanyCategory: type: object description: A category a company belongs to properties: id: type: integer description: Category identifier slug: type: string description: URL-safe category identifier name: type: string description: Display name of the category required: - id - slug - name additionalProperties: false CompanyResearchItem: type: object description: A research document about a company properties: id: type: string description: Research document identifier title: type: string description: Title of the document document_type: $ref: '#/components/schemas/CompanyResearchDocumentType' link: type: string description: Link to the document published_at: type: string format: date-time description: When the document was published required: - id - title - document_type - link - published_at additionalProperties: false CompanyNewsItem: type: object description: A news item about a company properties: id: type: integer description: News item identifier headline: type: string description: Headline of the news item description: type: string description: Summary of the news item published_at: type: string format: date-time description: When the news item was released articles: type: array description: Articles associated with the news item items: $ref: '#/components/schemas/CompanyNewsArticle' required: - id - headline - description - published_at - articles additionalProperties: false ErrorEnvelope: type: object description: Error body returned by every failing response properties: error: type: string description: Human-readable error message code: $ref: '#/components/schemas/ErrorCode' required: - error - code additionalProperties: false CompanyResearchDocumentType: type: string description: Kind of research document enum: - COMPANY - MARKET - INTERVIEW x-enum-varnames: - CompanyResearchDocumentTypeCompany - CompanyResearchDocumentTypeMarket - CompanyResearchDocumentTypeInterview CompanyNewsArticle: type: object description: An article associated with a news item properties: id: type: integer description: Article identifier headline: type: string description: Headline of the article summary: type: string description: Summary of the article link: type: string description: Link to the article publication: type: string description: Publication the article appeared in published_at: type: string format: date-time description: When the article was published required: - id - headline - summary - link - publication - published_at additionalProperties: false ErrorCode: type: string description: > Machine-readable error code. Mirrors external/domain/errors.go exactly; the wire strings are part of the public contract and must not drift from that file. enum: - unauthenticated - invalid_key - key_revoked - insufficient_scope - client_suspended - not_found - invalid_parameter - rate_limited - service_unavailable - internal_error responses: ErrorBadRequest: description: Invalid request parameter content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Invalid request parameter code: invalid_parameter ErrorUnauthorized: description: Missing, invalid, or revoked API credentials content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Missing API credentials code: unauthenticated ErrorForbidden: description: The API key lacks the required scope, or the client is suspended content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: API key does not grant the required scope code: insufficient_scope ErrorNotFound: description: The requested resource does not exist content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Resource not found code: not_found ErrorRateLimited: description: Too many requests content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Too many requests, please try again later code: rate_limited ErrorInternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Internal server error code: internal_error ErrorServiceUnavailable: description: The service is temporarily unavailable; retry later content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Service temporarily unavailable, please try again later code: service_unavailable securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: > The API key issued to your client. Send it on every request; a missing, unrecognised, or revoked key is rejected with 401. ````