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

# Look up companies

`POST /companies/lookup`

Takes up to 100 company ids, domains or company LinkedIn URLs and returns the matching company records. The result keeps the input order, one result per input. You pay one contact credit for each match, and a miss costs nothing. Each matched input costs one contact credit, including repeated inputs. A domain matches a company that carries it among its domains. A LinkedIn URL reduces to its company page.

Takes up to 100 company ids, domains or company LinkedIn URLs and returns the matching company records. The result keeps the input order, one result per input. You pay one contact credit for each match, and a miss costs nothing. Each matched input costs one contact credit, including repeated inputs. A domain matches a company that carries it among its domains. A LinkedIn URL reduces to its company page.

Cost: One contact credit per match. A miss costs nothing.

## Request body

- `inputs` | array of string | required. Up to 100 company ids, domains or company LinkedIn URLs. One input matches at most one company.

## Response

One result per input, in the same order as the request.

- `input` | string | required. The identifier exactly as the request sent it.
- `matched` | boolean | required. True when we hold the company. You pay one contact credit for each match, and a miss costs nothing.
- `company` | Company or null | required. The matched company, or null on a miss.
- `reason` | enum | optional. Present when the input is not a company id, a domain or a company LinkedIn URL. Such an input returns no company and costs nothing. Values: `invalid`.

## Failures

| Status | Meaning |
| --- | --- |
| `400` | The request shape, a filter key, a value, a cursor or the enrichment mode was rejected. |
| `401` | The credential is missing, unknown or revoked. |
| `402` | The daily or the monthly contact credit cap is spent, or the free plan's lifetime pool is. |
| `429` | The key passed 300 requests a minute or 2 concurrent requests. |
| `503` | The data is unavailable for a short time. |
| `504` | The query passed its time budget and was stopped. |

## Example

```bash
curl -sS -X POST "https://api.leadmcp.ai/v1/companies/lookup" \
  -H "Authorization: Bearer lm_live_YOUR_API_KEY" \
  -H "LeadMCP-Version: 2026-09-19" \
  -H "Content-Type: application/json" \
  -d '{"inputs":["example.com","https://www.linkedin.com/company/example"]}'
```

Response `200`:

```json
{
  "ok": true,
  "request_id": "req_01JBQ2W8K9V6M3T0X5Y7Z4A1BC",
  "release": "b_2026_09_15",
  "data": [
    {
      "input": "example.com",
      "matched": true,
      "company": {
        "id": "com_01JBQ2W8K9V6M3T0X5Y7Z4A1BC",
        "name": "Dana Reyes",
        "description": "description",
        "domain": "domain",
        "domains": [
          "domains"
        ],
        "linkedin": "https://www.linkedin.com/in/dana-reyes",
        "linkedin_urls": [
          "linkedin urls"
        ],
        "social": [
          {
            "network": "network",
            "url": "url",
            "username": "username",
            "followers": 1
          }
        ],
        "phone": "phone",
        "employee_count": 320,
        "headcount_band": "1-10",
        "founded_year": 0,
        "revenue_range": "0-1M",
        "employee_growth_pct": 1,
        "hq_city": "hq city",
        "hq_country": "hq country",
        "locations": [
          {
            "name": "Dana Reyes",
            "country": "us",
            "is_primary": true,
            "street": "street",
            "postcode": "postcode"
          }
        ],
        "industries": [
          "industries"
        ],
        "naics": [
          "naics"
        ],
        "specialties": [
          "specialties"
        ],
        "is_nonprofit": true,
        "is_government": true,
        "is_public": true,
        "total_funding_usd": 0,
        "last_round_type": "pre_seed",
        "last_round_usd": 0,
        "last_round_date": "2026-09-19",
        "investors": [
          "investors"
        ],
        "investor_count": 0,
        "monthly_visits": 0,
        "sic": [
          "sic"
        ],
        "last_updated": "2026-08"
      }
    },
    {
      "input": "https://www.linkedin.com/company/unknown-example",
      "matched": false,
      "company": null
    }
  ],
  "quota": {
    "plan": "free",
    "contact_credits_used": 50,
    "month_remaining": 950,
    "today_remaining": 950,
    "binding": "month",
    "resets_at": "9999-12-31T23:59:59.000Z"
  },
  "warnings": []
}
```