# Get Company

`GET https://api.getprospect.com/v2/companies/{id}`

Read one company by its GetProspect id, with your workspace's saved block (lists, saved_at, name edit). An unknown company answers 404 NOT_FOUND. Free: spends no credits; 1 unit of the enrich rate limit, none for a company your workspace saved.

## Authentication

Pass your API key in the `x-api-key` header.

## Path parameters

- `id` (string, required): The GetProspect company id (24 hexadecimal characters), as `id` on every company answer. Example: `"696fb12757da999990585cfd"`

## Example request

```bash
curl --request GET \
  --url https://api.getprospect.com/v2/companies/696fb12757da999990585cfd \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

The company, with `saved` when your workspace saved it.

```json
{
  "success": true,
  "data": {
    "id": "696fb12757da999990585cfd",
    "name": "Intercom",
    "description": "The AI customer service company.",
    "logo": "https://logos.getprospect.com/ecb5a93f5fb0f0718eaf4f75634c3cf5.jpg",
    "website": "intercom.com",
    "email": {
      "domain": "intercom.com",
      "provider": null
    },
    "linkedin_url": "https://linkedin.com/company/intercom",
    "social_networks": {
      "linkedin_url": "https://www.linkedin.com/company/intercom",
      "facebook_url": "https://www.facebook.com/intercom",
      "twitter_url": "https://x.com/intercom",
      "instagram_url": "https://www.instagram.com/intercom",
      "youtube_url": "https://www.youtube.com/@intercom",
      "tiktok_url": null,
      "crunchbase_url": "https://www.crunchbase.com/organization/intercom",
      "github_url": null,
      "pinterest_url": null
    },
    "industry": "Software Development",
    "keywords": [
      "Customer Support",
      "Live Chat",
      "Helpdesk"
    ],
    "naics_codes": [
      513210
    ],
    "type": "Privately Held",
    "business_type": "B2B",
    "revenue_stream": "Subscriptions / Recurring",
    "founded": 2011,
    "employee_count": 1800,
    "employee_range": "1001-5000",
    "location": {
      "city": "San Francisco",
      "state": "California",
      "state_code": "CA",
      "country": "United States",
      "country_code": "US",
      "raw_address": "55 2nd Street, 4th Floor, San Francisco, California 94105, US"
    },
    "other_locations": [
      {
        "city": "Dublin",
        "state": "Leinster",
        "state_code": "L",
        "country": "Ireland",
        "country_code": "IE",
        "raw_address": null
      }
    ],
    "saved": {
      "id": null,
      "saved_at": "2026-09-14T08:03:51.000Z",
      "list_ids": [
        "66f2c1d0a1b2c3d4e5f60718"
      ]
    },
    "technologies": [
      {
        "id": "3421",
        "name": "Intercom",
        "icon_url": "https://cdn.jsdelivr.net/gh/enthec/webappanalyzer@eea872af449e207e055398f7369d11ee48c8ea03/src/images/icons/Intercom.svg",
        "website": "https://www.intercom.com",
        "categories": [
          {
            "id": "53",
            "name": "CRM"
          },
          {
            "id": "52",
            "name": "Live chat"
          }
        ]
      }
    ],
    "technologies_checked_at": "2026-10-09T12:00:00.000Z"
  },
  "metadata": {
    "timestamp": "2026-10-02T12:27:10.726Z"
  }
}
```

## Response 400

Invalid request (`VALIDATION_ERROR`; `payload.code` says which kind of mistake).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-02T12:27:10.726Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "id must be a mongodb id",
      "payload": {
        "field": "id",
        "code": "invalid_format",
        "received_value": "stripe",
        "received_type": "string"
      }
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 404

No such company (`NOT_FOUND`): unknown, erased, or blocked by your workspace, which are not told apart.

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-02T12:27:10.726Z"
  },
  "errors": [
    {
      "name": "NOT_FOUND",
      "message": "Company 696fb12757da999990585cfe not found."
    }
  ]
}
```

## Response 429

Over the `enrich` rate limit (`RATE_LIMIT`); wait `Retry-After` seconds. Sent only where rate limits are enforced.

## Response 500

Unexpected server error.