API Reference
Every endpoint an API token can call, with its request shape, response shape and errors. All paths are relative to https://api.cornect.io/api/v1.
Companies#
- Search Companies — POST /companies/search — filter companies by location, industry, technologies, size; cursor pagination. Scope: read.
- Get Company — GET /companies/{company_id} — full company detail by id, 404 if not found. Scope: read.
- Get Company Job Postings — GET /companies/{company_id}/job-postings — open roles for one company, newest first. OFFSET paginated (page/page_size, max 50), unlike every other list endpoint. Scope: read.
- Count Companies — POST /companies/counts — exact match count without fetching rows; Search's total saturates at 10,000. Free. Scope: read.
Exports#
- Preview Export — POST /exports/preview — price an export before creating it: cost, what you already own, and how many rows a short balance would drop. Free. Scope: read.
- Create Export — POST /exports — create an export job from a search or list; charges credits per new company. A short balance exports partially. Scope: read_write.
- Get Export Status — GET /exports/{export_id} — poll an export job's status until it's ready. Scope: read.
- Download Export — POST /exports/{export_id}/download — get a presigned download URL for a completed export. Scope: read.
Credits#
- Get Credit Balance — GET /credits — current workspace credit balance + recent transactions. Scope: read.