Get Company Job Postings

GET/api/v1/companies/{company_id}/job-postings

Open job postings for one company, newest first. Returns an empty page rather than a 404 when the company has none, so a caller can render 'no open roles' without special-casing an error.

Authentication#

Requires a token with the read scope, sent as Authorization: Bearer cornect_….

Request#

Parameters:

Name	Type	Required	Description
`company_id`	string	Yes	Path parameter. The company, e.g. `a0383c53-8142-5e7c-8ca3-9980289a3ccc` — the `company_id` from a search result. A UUID, not a domain.
`page`	integer	No	1-based page number. Default `1`.
`page_size`	integer	No	Postings per page. Default `10`, maximum `50`.

Response#

total is the number of open postings for the company, so Math.ceil(total / page_size) gives the page count. Every field on an item except the title may be absent — the supplier does not populate all of them for every posting.

json

{
  "items": [
    {
      "title": "Staff Software Engineer",
      "seniority": "staff",
      "categories": ["engineering"],
      "location": "San Francisco, CA",
      "first_seen_at": "2026-07-14",
      "url": "https://…"
    }
  ],
  "total": 37,
  "page": 1,
  "page_size": 10
}

Pagination#

This endpoint uses pages, not cursors

Every list endpoint in this API is cursor-paginated except this one, which takes page and page_size. Code written against the cursor model will not work here: there is no next_cursor in the response, and passing cursor does nothing.

See Pagination for both models and which endpoints use which.

Offset paging is safe here in a way it would not be on search: a company's postings are a small, stable set, so a row cannot shift between pages the way a 13-million-row result set can.

Code samples#

curl -X GET https://api.cornect.io/api/v1/companies/a0383c53-8142-5e7c-8ca3-9980289a3ccc/job-postings?page=1&page_size=10 \
  -H "Authorization: Bearer cornect_your_token_here"

Errors#

See Errors for the full table. Codes you're most likely to see here:

Code	Status	When
`MISSING_AUTH_HEADER`	401	No Authorization header sent.
`INVALID_TOKEN`	401	Token not found or revoked.
`NOT_FOUND`	404	No such company. A company with no postings returns 200 and an empty list.
—	422	page_size above 50, or a non-integer page.