# API: Company signals

| Method | Path | What it does | Scope |
|---|---|---|---|
| GET | `/v1/accounts/:id/company` | An account's snapshot: open roles (7/30/90-day counts), ATS boards, leaders, technologies with evidence, and its changes | `accounts:read` |
| POST | `/v1/accounts/:id/company/check` | Queue a read of the account's careers, team and site pages, ATS boards, news and DNS now (it runs in the worker); pin keeps it watched nightly | `accounts:write` |
| DELETE | `/v1/accounts/:id/company/pin` | Stop watching an account nightly unless a monitor's audience includes it | `accounts:write` |
| GET | `/v1/company-changes` | Detected company changes, newest first: new roles, executive hires (with quotes), technologies added or removed, competitor churn | `prospecting:read` |

## Examples

### GET /v1/accounts/$ID/company

An account's snapshot: open roles (7/30/90-day counts), ATS boards, leaders, technologies with evidence, and its changes

```bash
curl -s "https://api.closefinch.com/v1/accounts/$ID/company" \
  -H "Authorization: Bearer $RA_API_KEY"
```

```js
const res = await fetch(`https://api.closefinch.com/v1/accounts/${id}/company`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();
```

### POST /v1/accounts/$ID/company/check

Queue a read of the account's careers, team and site pages, ATS boards, news and DNS now (it runs in the worker); pin keeps it watched nightly

```bash
curl -s -X POST "https://api.closefinch.com/v1/accounts/$ID/company/check" \
  -H "Authorization: Bearer $RA_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'
```

```js
const res = await fetch(`https://api.closefinch.com/v1/accounts/${id}/company/check`, {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({}), // fields: see the OpenAPI schema
});
const data = await res.json();
```

### DELETE /v1/accounts/$ID/company/pin

Stop watching an account nightly unless a monitor's audience includes it

```bash
curl -s -X DELETE "https://api.closefinch.com/v1/accounts/$ID/company/pin" \
  -H "Authorization: Bearer $RA_API_KEY"
```

```js
const res = await fetch(`https://api.closefinch.com/v1/accounts/${id}/company/pin`, {
  method: "DELETE",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();
```

### GET /v1/company-changes

Detected company changes, newest first: new roles, executive hires (with quotes), technologies added or removed, competitor churn

```bash
curl -s "https://api.closefinch.com/v1/company-changes" \
  -H "Authorization: Bearer $RA_API_KEY"
```

```js
const res = await fetch(`https://api.closefinch.com/v1/company-changes`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();
```

Request and response schemas: [https://www.closefinch.com/openapi.json](https://www.closefinch.com/openapi.json). All resources: [API reference](https://www.closefinch.com/docs/api).