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

# Get Company Profile

> Retrieve comprehensive company information by LinkedIn URL or domain

## Overview

Get detailed company information including business details, funding data, technology stack, employee metrics, and more. This endpoint provides comprehensive business intelligence for companies using either their LinkedIn URL or domain.

## Authentication

<ParamField header="X-API-KEY" type="string" required>
  Your Tuesday API key
</ParamField>

## Query Parameters

<ParamField query="linkedin_url" type="string">
  LinkedIn company page URL

  **Example:** `https://www.linkedin.com/company/salesforce`

  **Note:** Either `linkedin_url` or `domain` is required
</ParamField>

<ParamField query="domain" type="string">
  Company domain name

  **Example:** `salesforce.com`

  **Note:** Either `linkedin_url` or `domain` is required
</ParamField>

<ParamField query="include_funding" type="string" default="exclude">
  Include detailed funding and investment information

  **Options:** `include` | `exclude`

  **Additional Cost:** +2 credits when set to `include`
</ParamField>

<ParamField query="include_technology" type="string" default="exclude">
  Include technology stack and tools used by the company

  **Options:** `include` | `exclude`

  **Additional Cost:** +1 credit when set to `include`
</ParamField>

<ParamField query="include_contacts" type="string" default="exclude">
  Include key executive contacts and leadership information

  **Options:** `include` | `exclude`

  **Additional Cost:** +3 credits when set to `include`
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="Company Profile Data">
    <ResponseField name="id" type="string">
      Unique identifier for the company
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name
    </ResponseField>

    <ResponseField name="linkedin_url" type="string">
      LinkedIn company page URL
    </ResponseField>

    <ResponseField name="website_url" type="string">
      Primary website URL
    </ResponseField>

    <ResponseField name="primary_domain" type="string">
      Primary domain name
    </ResponseField>

    <ResponseField name="domains" type="array">
      All associated domain names
    </ResponseField>

    <ResponseField name="description" type="string">
      Company description and business overview
    </ResponseField>

    <ResponseField name="industry" type="string">
      Primary industry classification
    </ResponseField>

    <ResponseField name="industries" type="array">
      All industry classifications
    </ResponseField>

    <ResponseField name="specialities" type="array">
      Company specialities and focus areas
    </ResponseField>

    <ResponseField name="founded_year" type="number">
      Year the company was founded
    </ResponseField>

    <ResponseField name="company_size" type="string">
      Employee count range (e.g., "201-500")
    </ResponseField>

    <ResponseField name="employee_count" type="number">
      Estimated employee count
    </ResponseField>

    <ResponseField name="headquarters" type="object">
      <Expandable title="Headquarters Location">
        <ResponseField name="address" type="string">
          Full address
        </ResponseField>

        <ResponseField name="city" type="string">
          City
        </ResponseField>

        <ResponseField name="state" type="string">
          State/region
        </ResponseField>

        <ResponseField name="country" type="string">
          Country
        </ResponseField>

        <ResponseField name="postal_code" type="string">
          Postal/ZIP code
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="locations" type="array">
      All company office locations
    </ResponseField>

    <ResponseField name="phone" type="string">
      Primary phone number
    </ResponseField>

    <ResponseField name="logo_url" type="string">
      Company logo image URL
    </ResponseField>

    <ResponseField name="stock_symbol" type="string">
      Stock ticker symbol (if publicly traded)
    </ResponseField>

    <ResponseField name="type" type="string">
      Company type (e.g., "Public", "Private", "Non-profit")
    </ResponseField>

    <ResponseField name="annual_revenue" type="object">
      Revenue information when available
    </ResponseField>

    <ResponseField name="funding" type="object">
      Funding details (when `include_funding=include`)

      <Expandable title="Funding Information">
        <ResponseField name="total_funding" type="number">
          Total funding raised (USD)
        </ResponseField>

        <ResponseField name="last_funding_round" type="object">
          Details of most recent funding round
        </ResponseField>

        <ResponseField name="funding_rounds" type="array">
          Complete funding history
        </ResponseField>

        <ResponseField name="investors" type="array">
          List of investors and VCs
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="technology" type="object">
      Technology stack (when `include_technology=include`)

      <Expandable title="Technology Information">
        <ResponseField name="categories" type="array">
          Technology categories used
        </ResponseField>

        <ResponseField name="tools" type="array">
          Specific tools and platforms
        </ResponseField>

        <ResponseField name="integrations" type="array">
          Third-party integrations
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="contacts" type="array">
      Key contacts (when `include_contacts=include`)

      <Expandable title="Executive Contacts">
        <ResponseField name="name" type="string">
          Contact name
        </ResponseField>

        <ResponseField name="title" type="string">
          Job title
        </ResponseField>

        <ResponseField name="linkedin_url" type="string">
          LinkedIn profile URL
        </ResponseField>

        <ResponseField name="email" type="string">
          Email address (when available)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="statusCode" type="number">
  HTTP status code (200 for success)
</ResponseField>

<ResponseField name="message" type="string">
  Response message
</ResponseField>

## Example Requests

<CodeGroup>
  ```bash Basic Company Profile theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/profile?domain=salesforce.com' \
  --header 'X-API-KEY: your-api-key-here'
  ```

  ```bash LinkedIn URL Lookup theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/profile?linkedin_url=https://www.linkedin.com/company/salesforce' \
  --header 'X-API-KEY: your-api-key-here'
  ```

  ```bash Full Enrichment theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/profile?domain=salesforce.com&include_funding=include&include_technology=include&include_contacts=include' \
  --header 'X-API-KEY: your-api-key-here'
  ```

  ```javascript JavaScript theme={null}
  const companyData = async (domain) => {
    const params = new URLSearchParams({
      domain: domain,
      include_funding: 'include',
      include_technology: 'include',
      include_contacts: 'include'
    });

    const response = await fetch(
      `https://api.tuesday.so/api/v1/company/profile?${params}`,
      {
        headers: {
          'X-API-KEY': 'your-api-key-here'
        }
      }
    );

    const company = await response.json();
    return company;
  };

  // Usage
  const salesforce = await companyData('salesforce.com');
  console.log(salesforce);
  ```

  ```python Python theme={null}
  import requests

  def get_company_profile(domain=None, linkedin_url=None, full_enrichment=False):
      url = "https://api.tuesday.so/api/v1/company/profile"
      
      params = {}
      if domain:
          params['domain'] = domain
      elif linkedin_url:
          params['linkedin_url'] = linkedin_url
      else:
          raise ValueError("Either domain or linkedin_url is required")
      
      if full_enrichment:
          params.update({
              'include_funding': 'include',
              'include_technology': 'include',
              'include_contacts': 'include'
          })
      
      headers = {'X-API-KEY': 'your-api-key-here'}
      
      response = requests.get(url, params=params, headers=headers)
      return response.json()

  # Usage
  company = get_company_profile(domain='salesforce.com', full_enrichment=True)
  print(f"Company: {company['data']['name']}")
  print(f"Employees: {company['data']['employee_count']}")
  print(f"Industry: {company['data']['industry']}")
  ```

  ```php PHP theme={null}
  <?php
  function getCompanyProfile($domain = null, $linkedinUrl = null, $fullEnrichment = false) {
      $params = [];
      
      if ($domain) {
          $params['domain'] = $domain;
      } elseif ($linkedinUrl) {
          $params['linkedin_url'] = $linkedinUrl;
      } else {
          throw new Exception("Either domain or linkedin_url is required");
      }
      
      if ($fullEnrichment) {
          $params['include_funding'] = 'include';
          $params['include_technology'] = 'include';
          $params['include_contacts'] = 'include';
      }
      
      $queryString = http_build_query($params);
      
      $ch = curl_init();
      curl_setopt($ch, CURLOPT_URL, "https://api.tuesday.so/api/v1/company/profile?$queryString");
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($ch, CURLOPT_HTTPHEADER, [
          'X-API-KEY: your-api-key-here'
      ]);
      
      $response = curl_exec($ch);
      curl_close($ch);
      
      return json_decode($response, true);
  }

  // Usage
  $company = getCompanyProfile('salesforce.com', null, true);
  echo "Company: " . $company['data']['name'] . "\n";
  echo "Employees: " . $company['data']['employee_count'] . "\n";
  ?>
  ```
</CodeGroup>

## Example Response

<ResponseExample>
  ```json Response theme={null}
  {
      "data": {
          "id": "tu_cmp_sf2023",
          "name": "Salesforce",
          "linkedin_url": "https://www.linkedin.com/company/salesforce",
          "website_url": "https://www.salesforce.com",
          "primary_domain": "salesforce.com",
          "domains": [
              "salesforce.com",
              "force.com",
              "trailhead.com",
              "tableau.com"
          ],
          "description": "Salesforce is the global leader in Customer Relationship Management (CRM), bringing companies and customers together in the digital age.",
          "industry": "Computer Software",
          "industries": [
              "Computer Software",
              "Cloud Computing",
              "CRM Software"
          ],
          "specialities": [
              "CRM",
              "Cloud Computing",
              "Mobile",
              "Social",
              "Platform",
              "App Development",
              "Analytics"
          ],
          "founded_year": 1999,
          "company_size": "10001+",
          "employee_count": 79390,
          "headquarters": {
              "address": "415 Mission Street, 3rd Floor",
              "city": "San Francisco",
              "state": "California",
              "country": "United States",
              "postal_code": "94105"
          },
          "locations": [
              {
                  "city": "San Francisco",
                  "state": "California",
                  "country": "United States",
                  "is_headquarters": true
              },
              {
                  "city": "New York",
                  "state": "New York", 
                  "country": "United States",
                  "is_headquarters": false
              }
          ],
          "phone": "+1-415-901-7000",
          "logo_url": "https://logo.clearbit.com/salesforce.com",
          "stock_symbol": "CRM",
          "type": "Public",
          "annual_revenue": {
              "amount": 31352000000,
              "currency": "USD",
              "year": 2023
          },
          "funding": {
              "total_funding": 1700000000,
              "last_funding_round": {
                  "type": "IPO",
                  "amount": 110000000,
                  "date": "2004-06-23",
                  "valuation": 1100000000
              },
              "funding_rounds": [
                  {
                      "type": "Series A",
                      "amount": 4000000,
                      "date": "1999-12-01"
                  }
              ],
              "investors": [
                  "Kleiner Perkins",
                  "Oracle Corporation"
              ]
          },
          "technology": {
              "categories": [
                  "Customer Support",
                  "CRM",
                  "Analytics",
                  "Marketing Automation"
              ],
              "tools": [
                  "Slack",
                  "Tableau",
                  "MuleSoft",
                  "Heroku"
              ],
              "integrations": [
                  "Microsoft Office 365",
                  "Google Workspace",
                  "AWS"
              ]
          },
          "contacts": [
              {
                  "name": "Marc Benioff",
                  "title": "Chairman & CEO",
                  "linkedin_url": "https://www.linkedin.com/in/marcbenioff",
                  "email": "marc@salesforce.com"
              },
              {
                  "name": "Amy Weaver",
                  "title": "President & CFO",
                  "linkedin_url": "https://www.linkedin.com/in/amy-weaver-salesforce",
                  "email": "aweaver@salesforce.com"
              }
          ]
      },
      "statusCode": 200,
      "message": "Success"
  }
  ```
</ResponseExample>

## Credit Usage

<div className="grid grid-cols-1 md:grid-cols-4 gap-4 my-6">
  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-blue-600">
      {1}
    </div>

    <div className="text-sm text-gray-600">Base Profile</div>
  </div>

  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-green-600">
      {"+1"}
    </div>

    <div className="text-sm text-gray-600">Technology Stack</div>
  </div>

  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-orange-600">
      {"+2"}
    </div>

    <div className="text-sm text-gray-600">Funding Data</div>
  </div>

  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-red-600">
      {"+3"}
    </div>

    <div className="text-sm text-gray-600">Executive Contacts</div>
  </div>
</div>

## Data Sources & Accuracy

<AccordionGroup>
  <Accordion title="Data Sources">
    Company data is aggregated from multiple sources:

    * LinkedIn company pages and employee profiles
    * Company websites and SEC filings
    * Funding databases (Crunchbase, PitchBook)
    * Technology tracking services
    * Public business registries
  </Accordion>

  <Accordion title="Update Frequency">
    * Basic company information: Updated weekly
    * Employee counts: Updated monthly
    * Funding data: Updated within 24-48 hours of announcements
    * Technology stack: Updated quarterly
    * Executive contacts: Updated bi-weekly
  </Accordion>

  <Accordion title="Data Quality">
    * Public companies: 95%+ accuracy on core data
    * Private companies: 85-90% accuracy
    * Startups (\<2 years): 75-85% accuracy
    * Technology data: 80-85% accuracy
    * Contact information: 70-75% accuracy
  </Accordion>
</AccordionGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Domain vs LinkedIn URL">
    **Use domain when:**

    * You have the company's primary website
    * Working with large datasets of domains
    * Domain is well-established and matches company name

    **Use LinkedIn URL when:**

    * Domain lookup returns incorrect company
    * Working with subsidiaries or divisions
    * Need to ensure exact company match
  </Accordion>

  <Accordion title="Enrichment Strategy">
    **Start with basic profile** to verify the company, then add enrichments:

    * Basic profile (1 credit) - Verify company identity
    * Add funding data (+2 credits) - For investment analysis
    * Add technology (+1 credit) - For competitive intelligence
    * Add contacts (+3 credits) - For sales outreach
  </Accordion>

  <Accordion title="Handling Large Companies">
    For companies with subsidiaries:

    * Each subsidiary may have its own profile
    * Use specific LinkedIn URLs for divisions
    * Check `domains` array for all associated domains
    * Consider using [Company Search](/api-reference/company/search) to find related entities
  </Accordion>
</AccordionGroup>

## Error Responses

<AccordionGroup>
  <Accordion title="400 Bad Request - Missing Parameters">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request",
        "error": "Either domain or linkedin_url parameter is required"
    }
    ```
  </Accordion>

  <Accordion title="404 Not Found - Company Not Found">
    ```json theme={null}
    {
        "statusCode": 404,
        "message": "Not Found",
        "error": "No company found matching the provided criteria"
    }
    ```
  </Accordion>

  <Accordion title="400 Bad Request - Invalid LinkedIn URL">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request",
        "error": "Invalid LinkedIn URL format. Must be a company page URL"
    }
    ```
  </Accordion>
</AccordionGroup>

## Use Cases

<CardGroup cols={2}>
  <Card title="Sales Intelligence" icon="chart-line">
    Research target companies before sales outreach and meetings
  </Card>

  <Card title="Market Research" icon="magnifying-glass">
    Analyze competitors, market sizing, and industry trends
  </Card>

  <Card title="Investment Due Diligence" icon="scale-balanced">
    Evaluate companies for investment opportunities and partnerships
  </Card>

  <Card title="Lead Qualification" icon="filter">
    Qualify inbound leads and prioritize high-value prospects
  </Card>

  <Card title="Competitive Analysis" icon="chess-knight">
    Monitor competitor technology stacks and strategic moves
  </Card>

  <Card title="Account-Based Marketing" icon="bullseye">
    Create targeted campaigns based on company characteristics
  </Card>
</CardGroup>

## Company Profile Fields

<AccordionGroup>
  <Accordion title="Basic Information">
    Always included in the base response:

    * Company name and description
    * Industry and specialties
    * Founded year and size
    * Website and LinkedIn URLs
    * Headquarters location
  </Accordion>

  <Accordion title="Enhanced Data (Base)">
    Included when available:

    * Multiple office locations
    * Phone number and logo
    * Stock symbol (public companies)
    * Revenue information
    * All associated domains
  </Accordion>

  <Accordion title="Funding Information (+2 credits)">
    * Total funding raised
    * Funding round history
    * Investor list
    * Valuation data
    * IPO information
  </Accordion>

  <Accordion title="Technology Stack (+1 credit)">
    * Software categories used
    * Specific tools and platforms
    * Third-party integrations
    * Technology partnerships
  </Accordion>

  <Accordion title="Executive Contacts (+3 credits)">
    * C-level executives
    * VP-level leadership
    * Key decision makers
    * Direct contact information
  </Accordion>
</AccordionGroup>

## Related Endpoints

* [Company Search API](/api-reference/company/search) - Search for companies with filters
* [Company Employee Count](/api-reference/company/employee-count) - Get detailed employee metrics
* [Company Employee Search](/api-reference/company/employee-search) - Find employees within companies
* [People Search API](/api-reference/people/search) - Find people at specific companies