# Company Funders

> Look up an investor / fund profile (partners, thesis, check size, recent deals).

- **Endpoint:** `POST https://api.nyne.ai/company/funders`
- **Group:** Company APIs (https://api.nyne.ai/documentation/company.md)
- **Auth:** `X-API-Key` + `X-API-Secret` headers
- **Mode:** Asynchronous - submit returns a `request_id` (normally with `202 Accepted`); poll `GET /company/funders?request_id=<request_id>` with the same auth headers until the endpoint reports a terminal response. Where supported, a `callback_url` can notify you when queued work finishes; follow this endpoint's retrieval notes.
- **HTML version:** https://api.nyne.ai/documentation/company/funders

Retrieve a profile for an investment firm, VC fund, or angel investor - partners, investment thesis, typical check size, the rounds they invest in, portfolio locations, and recent investments. Supply at least one of `company_name` or `company_domain` (the investor’s name/domain - prefer the domain when available, it gives the strongest match). The request is queued asynchronously and returns a `request_id`; poll the status endpoint or supply a `callback_url`. Result arrays are bounded - up to 20 `partners`, 5 `investment_locations`, and 5 `recent_investments` - and fields with no data are omitted. A credit is charged only when investor data is found.

## Authentication

All `/person/*` and `/company/*` endpoints authenticate with an API key and secret sent as HTTP headers on every request: `X-API-Key` and `X-API-Secret`. Create keys from your Nyne.ai dashboard and keep the secret server-side. Rate limits: 100 requests/minute, 1,000 requests/hour. Full guide: https://api.nyne.ai/documentation/authentication.md

## Parameters

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `company_name` | string | no | Investor name to look up, e.g. “Y Combinator”, “Sequoia Capital”. Required unless `company_domain` is supplied. Max 255 chars. | "Sequoia Capital" |
| `company_domain` | string | no | Investor domain to look up, e.g. “sequoiacap.com”, “a16z.com”. Required unless `company_name` is supplied. Max 255 chars. | "sequoiacap.com" |
| `callback_url` | string | no | http(s) URL on an allowed host that receives the completed payload automatically. | "https://example.com/webhooks/funders" |

## Polling for the result

A newly queued submit normally returns `202 Accepted` with a `request_id`. Poll the same path until `status` is `completed` (results stay available afterwards). Where supported, pass a `callback_url` on the submit to receive a webhook when queued work finishes; keep the documented GET as a recovery and retrieval path:

```bash
curl "https://api.nyne.ai/company/funders?request_id=<request_id>" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
```

## Credit usage

| Item | Credits | Condition |
| --- | --- | --- |
| Investor Lookup | - | Charged once when investor data is retrieved |
| No data | 0 | No investor found never burns credits |

## Responses

| Code | Meaning |
| --- | --- |
| `202` | Investor lookup queued - poll the status endpoint with the returned request_id |
| `400` | missing_parameters / invalid_parameters / invalid_callback_url |
| `401` | Missing or invalid API credentials |
| `402` | insufficient_credits |
| `403` | subscription_required or ip_not_allowed |
| `404` | no funder data found (no credit charged) |
| `429` | rate_limit_exceeded / monthly_limit_exceeded |
| `503` | service_unavailable - the API is temporarily unavailable |

## Example request

### cURL

```bash
curl -X POST https://api.nyne.ai/company/funders \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Y Combinator",
    "callback_url": "https://example.com/webhooks/funders"
  }'
```

### Python

```python
import requests

resp = requests.post(
    "https://api.nyne.ai/company/funders",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "X-API-Secret": "YOUR_API_SECRET",
    },
    json={
        "company_name": "Y Combinator",
        "callback_url": "https://example.com/webhooks/funders",
    },
)
data = resp.json()
print(data)
```

### Node

```javascript
const resp = await fetch("https://api.nyne.ai/company/funders", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "X-API-Secret": "YOUR_API_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    company_name: "Y Combinator",
    callback_url: "https://example.com/webhooks/funders",
  }),
});
const data = await resp.json();
console.log(data);
```

### PHP

```php
<?php
$ch = curl_init("https://api.nyne.ai/company/funders");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "X-API-Key: YOUR_API_KEY",
    "X-API-Secret: YOUR_API_SECRET",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "company_name" => "Y Combinator",
    "callback_url" => "https://example.com/webhooks/funders",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
print_r($data);
```

## Example response

```json
{
  "request_id": "64f2d8e4fr1f065a9b4e7fbc3df6aabb_1700000123_6610",
  "status": "completed",
  "completed": true,
  "result": {
    "investor_name": "Y Combinator",
    "investor_domain": "ycombinator.com",
    "location": "Mountain View, CA, US",
    "investment_thesis": "Backs early-stage startups at the idea / seed stage.",
    "partners": [
      {
        "name": "Garry Tan",
        "linkedin_url": "https://www.linkedin.com/in/garrytan/"
      }
    ],
    "average_check_size": {
      "low": 125000,
      "high": 500000,
      "currency": "USD"
    },
    "rounds_they_invest_in": [
      "pre_seed",
      "seed"
    ],
    "recent_investments": [
      {
        "company_name": "Example Startup",
        "company_domain": "example.com",
        "amount": 500000,
        "currency": "USD"
      }
    ]
  },
  "completed_on": "2026-01-15T10:35:00Z"
}
```

---

All documentation pages are available as Markdown by appending `.md` to their URL. Index: https://api.nyne.ai/llms.txt