# Company details

> Name, industry, size, revenue range, location and more for one company domain.

`POST https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/api-company`

## Request

```bash
curl -X POST "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/api-company" \
  -H "Authorization: Bearer $PLATINUX_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain": "stripe.com"}'
```

| Body field | Type | Required | Notes |
|---|---|---|---|
| `domain` | string | Yes | The company's website. `https://www.stripe.com/about` is cleaned to `stripe.com` |

## Found: `200`, 1 credit

```json
{
  "status": "found",
  "domain": "stripe.com",
  "company": {
    "name": "Stripe",
    "website": "https://stripe.com",
    "description": "…",
    "slogan": "…",
    "industry": "Technology, Information and Internet",
    "specialties": [],
    "company_type": "Privately Held",
    "employee_count": 14127,
    "headcount_range": "5001-10000",
    "employee_growth": [],
    "revenue_range": {
      "estimatedMinRevenue": { "amount": 500, "unit": "MILLION", "currency": "USD" },
      "estimatedMaxRevenue": { "amount": 1, "unit": "BILLION", "currency": "USD" }
    },
    "founded_year": 2010,
    "location": {
      "streetAddress": "…", "addressLocality": "South San Francisco", "addressRegion": "California",
      "postalCode": "…", "addressCountry": "United States of America", "addressCountryCode": "US"
    },
    "phone": null,
    "logo_url": "https://…",
    "linkedin_url": "https://www.linkedin.com/company/stripe/",
    "linkedin_id": "stripe"
  },
  "domain_match": true,
  "source": "icypeas",
  "fetched_at": "2026-11-19T17:23:33Z",
  "cached": false,
  "credits_charged": 1
}
```

## Found again within 30 days: `200`, free

The same body with `"cached": true` and `"credits_charged": 0`.

## Not found: `200`, free

```json
{ "status": "not_found", "domain": "nonexistent-xyz-123.com", "company": null, "domain_match": null,
  "source": "icypeas", "fetched_at": "2026-11-19T18:21:40Z", "cached": false, "credits_charged": 0 }
```

## Fields

| Field | Meaning |
|---|---|
| `status` | `found` or `not_found` |
| `company` | The company, or `null` when not found. **Any field inside can be `null`**; `employee_growth` is often empty |
| `company.headcount_range` | Text, for example `"51-200"` |
| `company.revenue_range` | Estimated minimum and maximum revenue, each with `amount`, `unit` and `currency` |
| `company.location` | Head office address, as an object |
| `domain_match` | `false` when the company's listed website isn't exactly the domain you sent but the company matches (for example Google lists `goo.gle`). These matches are correct |
| `source` | Where the data came from |
| `fetched_at` | When the data was fetched |
| `cached` | `true` when the answer came from a lookup in the last 30 days |
| `credits_charged` | 1 for a new company found, otherwise 0 |

**Large brands may return a division:** a domain shared by several company pages returns the page linked to that domain (for example `amazon.com` returns Amazon Web Services).

## Errors

| HTTP | `error` | When |
|---|---|---|
| 400 | `invalid_input` | Body isn't JSON, or `domain` is missing |
| 400 | `invalid_domain` | A page on another site (for example a LinkedIn or Facebook link), not a company website |
| 401 | `unauthorized` | Missing, wrong or revoked key |
| 402 | `insufficient_credits` | No credits left |
| 502 | `provider_unavailable` | The data source didn't answer. Nothing was charged; try again |
