Metadata-Version: 2.4
Name: ejectseat
Version: 1.0.0
Summary: Official Python SDK for the EjectSeat layoff risk API — SEC filings, WARN notices, and risk scores.
Author: Admin Ace LLC
License: MIT
Project-URL: Homepage, https://ejectseat.io/developers
Project-URL: Repository, https://github.com/admin-ace-llc/ejectseat-sdk-py
Keywords: layoffs,sec-filings,warn-act,hr-tech,workforce,risk-score,api-client
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.20

# ejectseat

Official Python SDK for the [EjectSeat](https://ejectseat.io) layoff risk API.

Track corporate layoffs, restructurings, and workforce reductions from SEC EDGAR filings, WARN Act notices, earnings transcripts, and verified media reports.

## Install

```bash
pip install ejectseat
```

## Quick start

```python
from ejectseat import EjectSeat

es = EjectSeat("es_YOUR_KEY")

# Single company risk lookup
intel = es.company(ticker="INTC")
print(intel["data"]["risk"]["state"])   # "ACTIVE"
print(intel["data"]["risk"]["score"])   # 78

# Currently active layoffs
active = es.active()
for co in active["data"]:
    print(f"{co['company']} ({co['ticker']}) — {co['state']}, score {co['score']}")

# SEC 8-K events for a ticker
events = es.events(ticker="META", limit=5)

# WARN Act notices by state
warns = es.warn(state="CA", since="2026-01-01")

# Bulk company scores
companies = es.companies(state="ACTIVE", sort="score", limit=20)

# Check your API usage
usage = es.usage()
print(f"{usage['data']['queriesUsedToday']} / {usage['data']['queryLimitDaily']} queries used")
```

## Error handling

```python
from ejectseat import EjectSeat, EjectSeatError

es = EjectSeat("es_YOUR_KEY")
try:
    result = es.company(ticker="FAKE")
except EjectSeatError as e:
    print(e)          # "Company not found"
    print(e.status)   # 404
    print(e.code)     # "NOT_FOUND"
```

## API endpoints

| Method | Description |
|--------|-------------|
| `es.company(ticker=, name=)` | Full risk assessment for one company |
| `es.companies(state=, band=, sort=, limit=, offset=)` | Paginated bulk scores |
| `es.events(ticker=, since=, limit=)` | SEC 8-K layoff filings |
| `es.warn(state=, company=, since=, limit=)` | WARN Act notices |
| `es.active(state=, limit=)` | Currently laying-off companies |
| `es.usage()` | API key usage stats |

## Pricing

- **Starter** — $49/mo, 100 queries/day
- **Pro** — $199/mo, 10,000 queries/day

Get your API key at [ejectseat.io/developers](https://ejectseat.io/developers).

## License

MIT — Admin Ace LLC
