# Get Company Details by ID

Look up a company by Envo ID to retrieve available industry, size, headquarters and follower information with the EnvoAPI company details API.

`GET https://api.envoapi.com/v1/companies/details/by-id`

Operation ID: `getCompanyDetailsById`

## Authentication

See [Authentication](https://docs.envoapi.com/guides/authentication.md). Security alternatives (each object is one alternative):

```json
[
  {
    "BearerApiKey": []
  }
]
```

BearerApiKey:

```json
{
  "type": "http",
  "scheme": "bearer",
  "bearerFormat": "envo_<66 Base64url characters>"
}
```

## Credits

Uses the current Company base Credit cost. Check your dashboard for current costs; example charges are illustrative.

## Parameters

### publicId

Location: query. Required: yes.

Schema: [CompanyPublicId](https://docs.envoapi.com/api/schemas/CompanyPublicId.md)

Example:

```json
"company_4T4tWj"
```

## Request example

```bash
curl "https://api.envoapi.com/v1/companies/details/by-id?publicId=company_4T4tWj" \
  --header "Authorization: Bearer $ENVO_API_KEY" \
  --header "Accept: application/json"
```

## Responses

### 200

Company details. Some fields may be unavailable.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [CompanySuccess](https://docs.envoapi.com/api/schemas/CompanySuccess.md)

| Field                   | Required                  | Schema                                                                                                                                   | Description                                             |
| ----------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| data                    | yes                       | [CompanyDetailsData](https://docs.envoapi.com/api/schemas/CompanyDetailsData.md)                                                         | The result of the call. Fields we cannot fill are null. |
| data.publicId           | yes (when parent present) | [CompanyPublicId](https://docs.envoapi.com/api/schemas/CompanyPublicId.md)                                                               |                                                         |
| data.name               | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}]}                                                            |                                                         |
| data.slug               | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]}                                                             |                                                         |
| data.linkedinUrl        | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":8192,"format":"uri"},{"type":"null"}]}                                             |                                                         |
| data.websiteUrl         | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":8192,"format":"uri"},{"type":"null"}]}                                             |                                                         |
| data.description        | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":16384},{"type":"null"}]}                                                           |                                                         |
| data.tagline            | yes (when parent present) | {"anyOf":\[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}]}                                                            |                                                         |
| data.foundedOn          | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/PartialDate"},{"type":"null"}]}                                                                 |                                                         |
| data.organizationType   | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/OrganizationType"},{"type":"null"}]}                                                            |                                                         |
| data.specialties        | yes (when parent present) | {"anyOf":\[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":1024},"uniqueItems":true},{"type":"null"}]} |                                                         |
| data.primaryIndustry    | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/IndustryReference"},{"type":"null"}]}                                                           |                                                         |
| data.industries         | yes (when parent present) | {"anyOf":\[{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/IndustryReference"},"uniqueItems":true},{"type":"null"}]} |                                                         |
| data.employeeCount      | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/NonNegativeSafeInteger"},{"type":"null"}]}                                                      |                                                         |
| data.employeeCountRange | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/EmployeeCountRange"},{"type":"null"}]}                                                          |                                                         |
| data.followerCount      | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/NonNegativeSafeInteger"},{"type":"null"}]}                                                      |                                                         |
| data.logo               | yes (when parent present) | [ImageSlot](https://docs.envoapi.com/api/schemas/ImageSlot.md)                                                                           |                                                         |
| data.coverImage         | yes (when parent present) | [ImageSlot](https://docs.envoapi.com/api/schemas/ImageSlot.md)                                                                           |                                                         |
| data.headquarters       | yes (when parent present) | {"anyOf":\[{"$ref":"#/components/schemas/CompanyLocation"},{"type":"null"}]}                                                             |                                                         |
| data.locations          | yes (when parent present) | {"anyOf":\[{"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/CompanyLocation"}},{"type":"null"}]}                     |                                                         |
| data.products           | yes (when parent present) | {"anyOf":\[{"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/ProductItem"}},{"type":"null"}]}                         |                                                         |
| meta                    | yes                       | [CompanySuccessMetadata](https://docs.envoapi.com/api/schemas/CompanySuccessMetadata.md)                                                 | Information about the call itself.                      |
| meta.creditCost         | yes (when parent present) | [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md)                                                 | How many credits this call used.                        |

Response example:

```json
{
  "data": {
    "publicId": "company_4T4tWj",
    "name": "Microsoft",
    "slug": "microsoft",
    "linkedinUrl": "https://www.linkedin.com/company/microsoft/",
    "websiteUrl": "https://news.microsoft.com/",
    "description": "Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn't diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. Microsoft operates in 190 countries and is made up of approximately 228,000 passionate employees worldwide.",
    "tagline": null,
    "foundedOn": null,
    "organizationType": {
      "code": "publicCompany",
      "name": "Public Company"
    },
    "specialties": [
      "AI",
      "Advertising",
      "Artificial Intelligence",
      "Business Software",
      "Cloud Computing",
      "Developer Tools",
      "Developers",
      "Future of Work",
      "Gaming",
      "Home & Educational Software",
      "IT Professional",
      "Laptops",
      "Machine Learning",
      "Mixed Reality",
      "Productivity",
      "Quantum Computing",
      "Search",
      "Servers",
      "Smartphones",
      "Tablets",
      "Virtual Reality",
      "Windows Applications & Platforms",
      "Windows Operating System"
    ],
    "primaryIndustry": {
      "publicId": null,
      "name": "Software Development"
    },
    "industries": [
      {
        "publicId": null,
        "name": "Software Development"
      }
    ],
    "employeeCount": 232066,
    "employeeCountRange": {
      "start": 10001,
      "end": null
    },
    "followerCount": 29094127,
    "logo": [
      {
        "url": "https://image.envoapi.com/company-details/image-1.jpg",
        "width": 100,
        "height": 100
      },
      {
        "url": "https://image.envoapi.com/company-details/image-2.jpg",
        "width": 200,
        "height": 200
      },
      {
        "url": "https://image.envoapi.com/company-details/image-3.jpg",
        "width": 400,
        "height": 400
      }
    ],
    "coverImage": [
      {
        "url": "https://image.envoapi.com/company-details/image-4.jpg",
        "width": 200,
        "height": 33
      },
      {
        "url": "https://image.envoapi.com/company-details/image-5.jpg",
        "width": 400,
        "height": 66
      },
      {
        "url": "https://image.envoapi.com/company-details/image-6.jpg",
        "width": 4200,
        "height": 700
      }
    ],
    "headquarters": {
      "description": null,
      "address": {
        "line1": "1 Microsoft Way",
        "line2": null,
        "locality": "Redmond",
        "administrativeArea": "Washington",
        "postalCode": "98052",
        "country": "US",
        "countryCode": null
      }
    },
    "locations": [
      {
        "description": null,
        "address": {
          "line1": "1 Microsoft Way",
          "line2": null,
          "locality": "Redmond",
          "administrativeArea": "Washington",
          "postalCode": "98052",
          "country": "US",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "1 Denison Street",
          "line2": null,
          "locality": "North Sydney",
          "administrativeArea": "NSW",
          "postalCode": "2060",
          "country": "AU",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "1950 Meadowvale Blvd",
          "line2": null,
          "locality": "Mississauga",
          "administrativeArea": "Ontario",
          "postalCode": "L5N 8L9",
          "country": "CA",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "39, Quai du Président Roosevelt",
          "line2": null,
          "locality": "Issy-les-Moulineaux",
          "administrativeArea": "Île-de-France",
          "postalCode": "92130",
          "country": "FR",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Walter-Gropius-Straße 5",
          "line2": null,
          "locality": "München",
          "administrativeArea": null,
          "postalCode": "80807",
          "country": "DE",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "2-16-3 Konan",
          "line2": null,
          "locality": "Minato-ku",
          "administrativeArea": "Tokyo",
          "postalCode": "108-0075",
          "country": "JP",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Thames Valley Park Drive",
          "line2": null,
          "locality": "Reading",
          "administrativeArea": "Berkshire",
          "postalCode": "RG6 1WG",
          "country": "GB",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Kanalvej 7",
          "line2": null,
          "locality": "2800 Kongens Lyngby",
          "administrativeArea": null,
          "postalCode": null,
          "country": "DK",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Luchthavenlaan 1k",
          "line2": null,
          "locality": "Zaventem",
          "administrativeArea": "Flemish Region",
          "postalCode": "1930",
          "country": "BE",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Keilalahdentie 2-4",
          "line2": null,
          "locality": "Espoo",
          "administrativeArea": null,
          "postalCode": "02150",
          "country": "FI",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Viale Pasubio, 21",
          "line2": null,
          "locality": "Milan",
          "administrativeArea": "Lombardy",
          "postalCode": "20154",
          "country": "IT",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "50, Jongro 1-gil",
          "line2": null,
          "locality": "Jongno-gu",
          "administrativeArea": "Seoul",
          "postalCode": null,
          "country": "KR",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Evert van de Beekstraat 354",
          "line2": null,
          "locality": "Schiphol",
          "administrativeArea": "North Holland",
          "postalCode": "1118 CZ",
          "country": "NL",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Dronning Eufemia gate 71",
          "line2": null,
          "locality": "Oslo",
          "administrativeArea": null,
          "postalCode": "0194",
          "country": "NO",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Paseo del Club Deportivo, 1",
          "line2": "Centro Empresarial La Finca - Edificio 1",
          "locality": "Pozuelo de Alarcón",
          "administrativeArea": null,
          "postalCode": "28223",
          "country": "ES",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Regeringsgatan 25",
          "line2": null,
          "locality": "Stockholm",
          "administrativeArea": null,
          "postalCode": "111 53",
          "country": "SE",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "8058 Zürich-Flughafen",
          "line2": "The Circle 02",
          "locality": "Zürich",
          "administrativeArea": null,
          "postalCode": null,
          "country": "CH",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Av. President Juscelino Kubitscheck, 1909",
          "line2": null,
          "locality": "Sao Paulo",
          "administrativeArea": null,
          "postalCode": "04551-065",
          "country": "BR",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "海淀区，丹棱街5号",
          "line2": null,
          "locality": "中国",
          "administrativeArea": null,
          "postalCode": "100080",
          "country": "CN",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "DLF Building No.5 (Epitome), Cyber City, DLF Phase III",
          "line2": null,
          "locality": "Gurgaon",
          "administrativeArea": null,
          "postalCode": "122002",
          "country": "IN",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Av. Vasco de Quiroga 3200",
          "line2": "Col. Centro de Ciudad Santa Fe",
          "locality": "Del Álvaro Obregón",
          "administrativeArea": null,
          "postalCode": "01210",
          "country": "MX",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Ул. Крылатская, 17",
          "line2": null,
          "locality": "Москва",
          "administrativeArea": null,
          "postalCode": "121614",
          "country": "RU",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "3012 William Nicol Drive",
          "line2": null,
          "locality": "Johannesburg",
          "administrativeArea": "Gauteng",
          "postalCode": "2191",
          "country": "ZA",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Aydın Sokak No:7",
          "line2": "Bellevue Residences, Levent Mahallesi",
          "locality": "İstanbul",
          "administrativeArea": null,
          "postalCode": "34340",
          "country": "TR",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Am Europlatz 3",
          "line2": null,
          "locality": "Vienna",
          "administrativeArea": null,
          "postalCode": "1120",
          "country": "AT",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "100 Cyberport Road",
          "line2": "15/F, Cyberport 2",
          "locality": "Hong Kong",
          "administrativeArea": null,
          "postalCode": null,
          "country": "HK",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "One Microsoft Place",
          "line2": "South County Business Park",
          "locality": "Leopardstown",
          "administrativeArea": "Dublin",
          "postalCode": "18 D18",
          "country": "IE",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "רחוב הפנינה 2",
          "line2": null,
          "locality": "רעננה",
          "administrativeArea": null,
          "postalCode": "43107",
          "country": "IL",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "22 Viaduct Harbour Avenue",
          "line2": null,
          "locality": "Auckland",
          "administrativeArea": null,
          "postalCode": null,
          "country": "NZ",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Al. Jerozolimskie 195a",
          "line2": null,
          "locality": "Warszawa",
          "administrativeArea": null,
          "postalCode": "02-222",
          "country": "PL",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Rua do Fogo de Santelmo, Lote 2.07.02",
          "line2": null,
          "locality": "Lisboa",
          "administrativeArea": null,
          "postalCode": "1990 – 110",
          "country": "PT",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "The Business Gate, Building A2 Airport Road, Cordobah",
          "line2": null,
          "locality": "Riyadh",
          "administrativeArea": null,
          "postalCode": "11552",
          "country": "SA",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "182 Cecil Street",
          "line2": "#13-01 Frasers Tower",
          "locality": "Singapore",
          "administrativeArea": null,
          "postalCode": "069547",
          "country": "SG",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Pradiareň 1900",
          "line2": "Svätoplukova 2A",
          "locality": "Bratislava",
          "administrativeArea": null,
          "postalCode": "821 08",
          "country": "SK",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Zhongxiao East Road Section 5 No. 68",
          "line2": null,
          "locality": "Xinyi District",
          "administrativeArea": "Taipei City",
          "postalCode": null,
          "country": "TW",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Sheikh Zayed Road",
          "line2": "Dubai Internet City, Building No 8",
          "locality": "Dubai",
          "administrativeArea": null,
          "postalCode": "52244",
          "country": "AE",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "1106 Federal Capital",
          "line2": "Bouchard 710",
          "locality": "Buenos Aires",
          "administrativeArea": null,
          "postalCode": null,
          "country": "AR",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Av. Vitacura 6844",
          "line2": null,
          "locality": "Santiago",
          "administrativeArea": null,
          "postalCode": null,
          "country": "CL",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Calle 92 # 11 – 51",
          "line2": null,
          "locality": "Bogota",
          "administrativeArea": null,
          "postalCode": null,
          "country": "CO",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Kilo 28, Cairo/Alex Desert Road",
          "line2": "Abou Rawash",
          "locality": "Cairo",
          "administrativeArea": null,
          "postalCode": null,
          "country": "EG",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Jl. Jend. Sudirman Kav. 52-53",
          "line2": "Jakarta Stock Exchange Building Tower II",
          "locality": "Jakarta",
          "administrativeArea": null,
          "postalCode": "12190",
          "country": "ID",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "No. 211, Jalan Tun Sambanthan",
          "line2": "Menara Shell",
          "locality": "Kuala Lumpur",
          "administrativeArea": null,
          "postalCode": "50470",
          "country": "MY",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Ayala Avenue cor Edsa, Brgy. San Lorenzo,",
          "line2": "11F, One Ayala East Tower",
          "locality": "Makati City",
          "administrativeArea": null,
          "postalCode": "1223",
          "country": "PH",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "Bulevardul Iuliu Maniu nr. 6P",
          "line2": "Clădirea Campus 6.2",
          "locality": "București",
          "administrativeArea": null,
          "postalCode": "061103",
          "country": "RO",
          "countryCode": null
        }
      },
      {
        "description": null,
        "address": {
          "line1": "87/2 ถนนวิทยุ แขวงลุมพินี",
          "line2": "ตึก CRC Tower ออลซีซันส์เพลส",
          "locality": "เขตปทุมวัน กรุงเทพฯ",
          "administrativeArea": null,
          "postalCode": "10330",
          "country": "TH",
          "countryCode": null
        }
      }
    ],
    "products": []
  },
  "meta": {
    "creditCost": 1
  }
}
```

### 400

A request parameter is missing or invalid.

A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [InvalidRequestErrorResponse](https://docs.envoapi.com/api/schemas/InvalidRequestErrorResponse.md)

### 401

Your API key is invalid or inactive.

Your API key is missing, wrong or switched off. Check it in your dashboard.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [InvalidApiKeyErrorResponse](https://docs.envoapi.com/api/schemas/InvalidApiKeyErrorResponse.md)

### 402

Your account does not have enough credits.

Your account has no credits left. Top up, then send a new call.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [InsufficientCreditsErrorResponse](https://docs.envoapi.com/api/schemas/InsufficientCreditsErrorResponse.md)

### 403

Your API key or account cannot access this endpoint.

Your account is suspended or cannot use this endpoint. Resolve the account or its access first.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [LookupForbiddenErrorResponse](https://docs.envoapi.com/api/schemas/LookupForbiddenErrorResponse.md)

### 404

The requested resource was not found.

Nothing matched what you sent. Check it for typos.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [ResourceNotFoundErrorResponse](https://docs.envoapi.com/api/schemas/ResourceNotFoundErrorResponse.md)

### 405

Use GET for this endpoint.

The route exists, but the request used a method other than GET. Use the method shown at the top of this page.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **Allow**: Required response header. Schema: {"type":"string","const":"GET"}.

Content type: `application/json`.

Schema: [MethodNotAllowedErrorResponse](https://docs.envoapi.com/api/schemas/MethodNotAllowedErrorResponse.md)

### 406

The response format in your Accept header is not supported.

The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [NotAcceptableErrorResponse](https://docs.envoapi.com/api/schemas/NotAcceptableErrorResponse.md)

### 415

The Content-Type in your request is not supported.

The request declared a media type we do not accept. Remove the body or use the documented media type.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.

Content type: `application/json`.

Schema: [UnsupportedMediaTypeErrorResponse](https://docs.envoapi.com/api/schemas/UnsupportedMediaTypeErrorResponse.md)

### 429

Your account has sent too many requests.

Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **Retry-After**: Seconds to wait before you try again. Schema: [PositiveSafeInteger](https://docs.envoapi.com/api/schemas/PositiveSafeInteger.md).

Content type: `application/json`.

Schema: [RateLimitExceededErrorResponse](https://docs.envoapi.com/api/schemas/RateLimitExceededErrorResponse.md)

### 500

A server error prevented the request from completing.

Something failed on our side. Retry only when error.retryable is true.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [InternalServerErrorResponse](https://docs.envoapi.com/api/schemas/InternalServerErrorResponse.md)

### 502

A data source returned an invalid response.

A data source sent back something we could not use. Retry with bounded backoff.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [UpstreamErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamErrorResponse.md)

### 503

The service is unavailable. Check error.retryable before retrying.

Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **Retry-After**: Seconds to wait before you try again. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [ServiceUnavailableErrorResponse](https://docs.envoapi.com/api/schemas/ServiceUnavailableErrorResponse.md)

### 504

The request timed out.

The lookup ran out of time. Retry with bounded backoff.

* **Date**: Required response header. Schema: [HttpDateHeader](https://docs.envoapi.com/api/schemas/HttpDateHeader.md).
* **Cache-Control**: Do not cache the reply. Schema: [CacheControlHeader](https://docs.envoapi.com/api/schemas/CacheControlHeader.md).
* **X-Request-Id**: A unique ID for this call. Quote it if you contact support. Schema: [RequestId](https://docs.envoapi.com/api/schemas/RequestId.md).
* **Content-Type**: Required response header. Schema: {"type":"string","const":"application/json; charset=utf-8"}.
* **X-Credits-Remaining**: Credits left on your account after this call. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Limit**: The Account's current rolling request ceiling. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Remaining**: Requests remaining in the current rolling window. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).
* **X-RateLimit-Reset**: Whole seconds until capacity resets, rounded up. Schema: [NonNegativeSafeInteger](https://docs.envoapi.com/api/schemas/NonNegativeSafeInteger.md).

Content type: `application/json`.

Schema: [UpstreamTimeoutErrorResponse](https://docs.envoapi.com/api/schemas/UpstreamTimeoutErrorResponse.md)

## Related documentation

* [Authentication](https://docs.envoapi.com/guides/authentication.md)

* [Errors](https://docs.envoapi.com/guides/errors.md)

* [Pagination](https://docs.envoapi.com/guides/pagination.md)

* [Rate limits](https://docs.envoapi.com/guides/rate-limits.md)

* [Get Company posts.](https://docs.envoapi.com/api/operations/getcompanyposts.md)

* [Get Company employees.](https://docs.envoapi.com/api/operations/getcompanypeople.md)

* [Get Company products.](https://docs.envoapi.com/api/operations/getcompanyproducts.md)

* [Get a Company's recent jobs.](https://docs.envoapi.com/api/operations/getcompanyjobs.md)

* [Get Company Details by URL](https://docs.envoapi.com/api/operations/getcompanydetailsbyurl.md)

* [Get Company Details by slug](https://docs.envoapi.com/api/operations/getcompanydetailsbyslug.md)

* [Get companies similar to a Company by URL](https://docs.envoapi.com/api/operations/getsimilarcompaniesbyurl.md)

* [Get companies similar to a Company by slug](https://docs.envoapi.com/api/operations/getsimilarcompaniesbyslug.md)

[Documentation index](https://docs.envoapi.com/llms.txt) · [All endpoints](https://docs.envoapi.com/api/index.md)