Companies

Retrieve a company

Returns a single company by ID.

get/companies/{id}

Request

  • Base URL
    https://www.happyscribe.com/api/v1
  • Auth
    API key in header Authorization

Path parameters

idinteger required

ID of the company.

Response

The company.

idinteger

Unique identifier.

namestring

The company name.

primary_domainstring

The primary web domain for the company.

domainsstring[]

All known domains, including primary_domain.

industrystring nullable

Industry classification from enrichment.

employee_countinteger nullable

Approximate number of employees from enrichment.

founded_yearinteger nullable

Year founded.

short_descriptionstring nullable

A one-line description.

keywordsstring[]

Keywords describing the company.

citystring nullable

Headquarters city.

countrystring nullable

Headquarters country.

website_urlstring nullable

The company website.

linkedin_urlstring nullable

The company LinkedIn page.

logo_urlstring nullable

The company logo.

total_fundingnumber nullable

Total funding raised in USD. May be null even when enrichment has run.

annual_revenuenumber nullable

Estimated annual revenue in USD. May be null even when enrichment has run.

latest_funding_stagestring nullable

Most recent funding stage, e.g. Series A. May be null even when enrichment has run.

created_atstring date-time

When it was created, in ISO 8601.

updated_atstring date-time

When it last changed, in ISO 8601.

Example response

{
  "id": 1,
  "name": "Acme Corp",
  "primary_domain": "acme.com",
  "domains": [
    "acme.com",
    "acme.co"
  ],
  "industry": "Technology",
  "employee_count": 500,
  "founded_year": 2010,
  "short_description": "Project management software for modern teams.",
  "keywords": [
    "saas",
    "productivity",
    "collaboration"
  ],
  "city": "San Francisco",
  "country": "United States",
  "website_url": "https://acme.com",
  "linkedin_url": "https://linkedin.com/company/acme-corp",
  "logo_url": "https://example.com/logo.png",
  "total_funding": null,
  "annual_revenue": null,
  "latest_funding_stage": null,
  "created_at": "2024-01-15T10:00:00.000Z",
  "updated_at": "2024-06-01T12:00:00.000Z",
  "_links": {
    "self": {
      "url": "https://www.happyscribe.com/api/v1/companies/1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.