> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryfundable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Company

> Retrieve detailed company information using any supported identifier format.
The API intelligently detects the identifier type and queries accordingly.

Provide ONE of the following query parameters to identify the company:
- `id` - Company UUID
- `domain` - Company domain or full URL (e.g., "stripe.com" or "https://stripe.com")
- `linkedin` - LinkedIn company URL
- `crunchbase` - Crunchbase organization URL

The response includes the company's latest funding round details with participating investors.




## OpenAPI

````yaml openapi/openapi-companies.yaml GET /company
openapi: 3.0.3
info:
  title: Fundable Companies API
  description: >
    API for accessing company data including search, detailed company
    information, and filtered company discovery.


    ## Authentication

    All API requests require authentication using an API key in the
    Authorization header.


    ## Rate Limits

    API usage is tracked and may be subject to monthly limits depending on your
    API key tier.


    ## Company Identifiers

    Companies can be identified using query parameters with any of the following
    formats:

    - `id` - UUID format (e.g., "?id=550e8400-e29b-41d4-a716-446655440000")

    - `domain` - Domain or full URL (e.g., "?domain=stripe.com" or
    "?domain=https://stripe.com")

    - `linkedin` - LinkedIn company URL (e.g.,
    "?linkedin=https://linkedin.com/company/stripe")

    - `crunchbase` - Crunchbase organization URL (e.g.,
    "?crunchbase=https://crunchbase.com/organization/stripe")


    ## Parameter Validation (for /companies endpoint)

    The /companies endpoint (POST) enforces strict validation on the JSON
    request body:

    - **Unknown Fields**: Any field not in the allowed set will result in a `422
    UNKNOWN_PARAMETER` error

    - **Enum Values**: Fields like `financing_types`, `sort_by`,
    `employee_count`, and `ipo_status` only accept exact enum values

    - **Data Types**: Numeric fields must be valid numbers, dates must be valid
    ISO 8601 format

    - **Array Fields**: Cannot be empty arrays; provide values or omit the field
    entirely


    ## Semantic Search

    The /companies endpoint supports AI-powered semantic search via
    `company.search_query`.

    Think of it as a flexible replacement for an industry tag: use it to
    pinpoint a **niche

    industry or specific product type** by describing what a company does — its
    product,

    technology, or business model (e.g. "AI-powered medical imaging diagnostics"
    or "vertical

    SaaS for dental practices"). It is best for product/category targeting that
    the fixed

    industry list can't capture. It is not a keyword filter: do not put other
    attributes like

    stage, location, funding, or employee count in `search_query` — apply those
    with the

    dedicated filter fields instead, and combine them with semantic search.
    Results come back

    with a `similarity` score (0-1) and are sorted by relevance.
  version: 1.0.0
  contact:
    name: Fundable API Support
    url: jacob@tryfundable.ai
  license:
    name: Proprietary
    url: https://www.tryfundable.ai/terms/privacy/
servers:
  - url: https://www.tryfundable.ai/api/v1
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: companies
    description: Company data, search, and discovery operations
paths:
  /company:
    get:
      summary: Get company details and recent funding by identifier
      description: >
        Retrieve detailed company information using any supported identifier
        format.

        The API intelligently detects the identifier type and queries
        accordingly.


        Provide ONE of the following query parameters to identify the company:

        - `id` - Company UUID

        - `domain` - Company domain or full URL (e.g., "stripe.com" or
        "https://stripe.com")

        - `linkedin` - LinkedIn company URL

        - `crunchbase` - Crunchbase organization URL


        The response includes the company's latest funding round details with
        participating investors.
      operationId: getCompany
      parameters:
        - name: id
          in: query
          description: Company UUID
          required: false
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: domain
          in: query
          description: >-
            Company domain or full URL (e.g., "stripe.com" or
            "https://stripe.com") — URLs are automatically parsed to extract the
            domain
          required: false
          schema:
            type: string
          example: stripe.com
        - name: linkedin
          in: query
          description: LinkedIn company URL
          required: false
          schema:
            type: string
          example: https://linkedin.com/company/stripe
        - name: crunchbase
          in: query
          description: Crunchbase organization URL
          required: false
          schema:
            type: string
          example: https://crunchbase.com/organization/stripe
      responses:
        '200':
          description: Successful response with company data
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      company:
                        $ref: '#/components/schemas/CompanyDetails'
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                        example: 0
                      page_size:
                        type: integer
                        example: 1
                      credits_used:
                        type: integer
                        description: Number of credits consumed by this request
                        example: 10
                      credit_source:
                        type: string
                        nullable: true
                        enum:
                          - monthly
                          - purchased
                        description: >-
                          Source of credits used (only included for non-API tier
                          keys)
                        example: monthly
                      monthly_credits_remaining:
                        type: integer
                        nullable: true
                        description: >-
                          Remaining monthly credits (only included for non-API
                          tier keys)
                        example: 990
                      purchased_credits_remaining:
                        type: integer
                        nullable: true
                        description: >-
                          Remaining purchased credits (only included for non-API
                          tier keys)
                        example: 500
                required:
                  - success
                  - data
                  - meta
        '400':
          description: Bad request - missing identifier or invalid format
          content:
            application/json:
              schema:
                type: object
                description: Missing identifier error
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: MISSING_IDENTIFIER
                      message:
                        type: string
                        example: Company identifier is required
                      details:
                        type: object
                        properties:
                          help:
                            type: string
                            example: >-
                              Provide an identifier using one of the query
                              parameters: id, domain, linkedin, or crunchbase
                          examples:
                            type: object
                            properties:
                              byDomain:
                                type: string
                                example: /api/v1/company?domain=stripe.com
                              byLinkedIn:
                                type: string
                                example: >-
                                  /api/v1/company?linkedin=https://linkedin.com/company/stripe
                              byCrunchbase:
                                type: string
                                example: >-
                                  /api/v1/company?crunchbase=https://crunchbase.com/organization/stripe
                              byId:
                                type: string
                                example: >-
                                  /api/v1/company?id=550e8400-e29b-41d4-a716-446655440000
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '402':
          description: Insufficient credits to complete request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsufficientCreditsError'
        '404':
          description: Company not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '429':
          description: Rate limit exceeded (per-minute)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitError'
          headers:
            Retry-After:
              description: Number of seconds to wait before retrying
              schema:
                type: integer
                example: 60
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerError'
components:
  schemas:
    CompanyDetails:
      type: object
      description: Full company details returned by the /company endpoint
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the company
          example: 550e8400-e29b-41d4-a716-446655440000
        name:
          type: string
          nullable: true
          description: Company name
          example: Acme Corporation
        legal_name:
          type: string
          nullable: true
          description: Legal name of the company
          example: Acme Corporation Inc.
        guru_permalink:
          type: string
          nullable: true
          description: Fundable permalink for the company
          example: acme-corporation
        domain:
          type: string
          nullable: true
          description: Company website domain
          example: acme.com
        region:
          type: string
          nullable: true
          description: Company region
          example: San Francisco Bay Area
        short_description:
          type: string
          nullable: true
          description: Brief description of the company
        long_description:
          type: string
          nullable: true
          description: >-
            Full description of the company. Available on /company endpoint; may
            be null on /companies list endpoint.
        num_employees:
          type: string
          nullable: true
          description: Number of employees range
          example: 11-50
        linkedin:
          type: string
          nullable: true
          format: uri
          description: LinkedIn profile URL
        twitter:
          type: string
          nullable: true
          format: uri
          description: Twitter profile URL
        facebook:
          type: string
          nullable: true
          format: uri
          description: Facebook profile URL
        pitchbook:
          type: string
          nullable: true
          format: uri
          description: PitchBook profile URL
        crunchbase:
          type: string
          nullable: true
          format: uri
          description: Crunchbase profile URL
        address:
          type: string
          nullable: true
          description: Company address
        ipo_status:
          type: string
          nullable: true
          description: IPO status of the company
          enum:
            - public
            - private
          example: private
        num_funding_rounds:
          type: integer
          nullable: true
          description: Number of funding rounds
          example: 11
        num_investors:
          type: integer
          nullable: true
          description: Number of investors
          example: 14
        total_raised:
          type: number
          nullable: true
          description: Total amount raised (USD)
          example: 2834940000
        latest_valuation_usd:
          type: number
          nullable: true
          description: Latest valuation (USD)
          example: 31000000000
        latest_valuation_date:
          type: string
          format: date-time
          nullable: true
          description: Date of latest valuation
          example: '2017-03-09T00:00:00.000Z'
        industries:
          type: array
          description: Industries the company operates in
          items:
            type: object
            properties:
              permalink:
                type: string
                description: Industry permalink
                example: artificial-intelligence
              name:
                type: string
                description: Industry name
                example: Artificial Intelligence
        location:
          type: object
          description: Company location hierarchy
          properties:
            region:
              type: object
              nullable: true
              properties:
                name:
                  type: string
                  description: Region name
                  example: San Francisco Bay Area
                permalink:
                  type: string
                  description: Region permalink
                  example: san-francisco-bay-area
            country:
              type: object
              nullable: true
              properties:
                name:
                  type: string
                  description: Country name
                  example: United States
                permalink:
                  type: string
                  description: Country permalink
                  example: united-states
            state:
              type: object
              nullable: true
              properties:
                name:
                  type: string
                  description: State name
                  example: California
                permalink:
                  type: string
                  description: State permalink
                  example: california
            city:
              type: object
              nullable: true
              properties:
                name:
                  type: string
                  description: City name
                  example: San Francisco
                permalink:
                  type: string
                  description: City permalink
                  example: san-francisco-california
        latest_deal:
          $ref: '#/components/schemas/LatestDeal'
        all_investor_ids:
          type: array
          nullable: true
          description: >-
            UUIDs of all parent investors across all funding rounds for this
            company
          items:
            type: string
            format: uuid
          example:
            - c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82
            - c6bc63af-cb37-453d-9c20-35f56fb87ee9
        similarity:
          type: number
          nullable: true
          description: >-
            Semantic similarity score (0-1). Only present when using
            search_query parameter.
          example: null
    AuthError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - AUTH_ERROR
                - INVALID_API_KEY
                - INACTIVE_API_KEY
              example: AUTH_ERROR
            message:
              type: string
              example: API key not provided
            details:
              type: object
              properties:
                help:
                  type: string
                  example: Please provide your API key in the Authorization header
                format:
                  type: string
                  example: Bearer vg_your_api_key_here
      required:
        - error
    InsufficientCreditsError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: INSUFFICIENT_CREDITS
            message:
              type: string
              example: >-
                Not enough credits to complete this request. Visit
                https://www.tryfundable.ai/api-access to purchase more.
            details:
              type: object
              properties:
                credits_needed:
                  type: integer
                  nullable: true
                  description: >-
                    Number of credits required (included when known
                    post-execution)
                  example: 25
                monthly_credits_remaining:
                  type: integer
                  description: Remaining monthly credits
                  example: 0
                purchased_credits_remaining:
                  type: integer
                  description: Remaining purchased credits
                  example: 0
                help:
                  type: string
                  example: >-
                    Purchase additional credits at
                    https://www.tryfundable.ai/api-access or upgrade your plan.
      required:
        - error
    NotFoundError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - COMPANY_NOT_FOUND
              example: COMPANY_NOT_FOUND
            message:
              type: string
              example: Company not found
            details:
              type: object
              properties:
                help:
                  type: string
                  example: >-
                    Please check the company identifier (ID, domain, LinkedIn
                    URL, or Crunchbase URL) and try again
      required:
        - error
    RateLimitError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: RATE_LIMIT_EXCEEDED
            message:
              type: string
              example: Rate limit exceeded. Maximum 200 requests per minute.
            details:
              type: object
              properties:
                limit:
                  type: integer
                  description: Maximum requests allowed per window
                  example: 200
                window:
                  type: string
                  description: Rate limit window duration
                  example: 60 seconds
                help:
                  type: string
                  example: Please reduce your request frequency and try again.
      required:
        - error
    ServerError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: INTERNAL_SERVER_ERROR
            message:
              type: string
              example: An unexpected error occurred
            details:
              type: string
              nullable: true
              description: Error details (only in development mode)
      required:
        - error
    LatestDeal:
      type: object
      nullable: true
      description: Details of the company's most recent funding round
      properties:
        id:
          type: string
          format: uuid
          nullable: true
          description: Unique identifier for the deal
        type:
          type: string
          nullable: true
          description: Type of funding round
          enum:
            - SERIES_A
            - SERIES_B
            - SERIES_C
            - SERIES_D
            - SERIES_E
            - SERIES_F
            - SERIES_G
            - SERIES_H
            - SERIES_I
            - SERIES_J
            - SERIES_K
            - SERIES_M
            - SEED
            - SAFE
            - CONVERTIBLE_NOTE
            - EQUITY
            - PREFERRED
            - SECONDARY_MARKET
            - DEBT_FINANCING
            - GRANT
            - NON_EQUITY_ASSISTANCE
            - CROWDFUNDING
            - INITIAL_COIN_OFFERING
            - FUNDING_ROUND
            - HYBRID
            - HYBRID_SEED
            - HYBRID_SERIES_A
            - HYBRID_SERIES_B
            - HYBRID_SERIES_C
            - HYBRID_SERIES_D
            - HYBRID_SERIES_E
            - HYBRID_SERIES_F
            - HYBRID_SERIES_G
            - HYBRID_SERIES_H
            - HYBRID_SERIES_I
            - HYBRID_SERIES_J
            - HYBRID_SERIES_K
            - HYBRID_SERIES_M
          example: SERIES_B
        total_round_raised:
          type: number
          nullable: true
          description: Total amount raised in the round (USD)
          example: 25000000
        date:
          type: string
          format: date-time
          nullable: true
          description: Date of the funding round
          example: '2024-01-15T00:00:00Z'
        extension:
          type: boolean
          nullable: true
          description: Whether this is an extension round
          example: false
        pre:
          type: boolean
          nullable: true
          description: Whether this is a pre-round (e.g., Pre-Series A)
          example: false
        intermediate:
          type: string
          nullable: true
          description: Intermediate round designation
          enum:
            - PLUS
            - NONE
            - ONE
            - TWO
            - THREE
            - FOUR
            - FIVE
            - SIX
            - SEVEN
            - EIGHT
          example: NONE
        description:
          type: object
          nullable: true
          properties:
            short_description:
              type: string
              nullable: true
              description: Brief description of the deal
            long_description:
              type: string
              nullable: true
              description: Detailed description of the deal
        investors:
          type: array
          description: >-
            UUIDs of firm investors participating in this deal. Angels are
            surfaced separately in `angel_investor_ids`.
          items:
            type: string
            format: uuid
          example:
            - c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82
            - c6bc63af-cb37-453d-9c20-35f56fb87ee9
        angel_investor_ids:
          type: array
          description: >-
            UUIDs of angel investors (people) on this latest deal. Resolve via
            `/people/{id}`. Empty array when no angels.
          items:
            type: string
            format: uuid
          example:
            - b3e9c7d1-2f4a-4d5e-9c1b-7a8f3e2d1c6a
        financings:
          type: array
          description: Individual financing tranches in this deal
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                description: Unique identifier for the financing
              type:
                type: string
                description: Type of financing
              size_usd:
                type: number
                nullable: true
                description: Financing amount in USD
                example: 25000000
              size_native:
                type: number
                nullable: true
                description: Financing amount in native currency
                example: 25000000
              currency:
                type: string
                nullable: true
                description: Currency code for size_native
                example: USD
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |
        API key authentication using Bearer token format.
        Format: `Authorization: Bearer vg_your_api_key_here`

        API keys follow the pattern: `vg_[12_hex_chars]_[32_base64url_chars]`

````