Quickstart

You'll need the API token CareerOS issued during onboarding. Don't have one yet? Email support@thecareeros.com.

1. Store the token

export TOKEN="eyJhbGciOiJIUzI1NiIs..."   # keep it in a secret manager in production

2. Discover your universities

Your token scopes everything. Start by listing the universities it can see — one row for a university token, every member school for a consortium token:

curl 'https://api.partners.thecareeros.com/v1/universities' \
  -H "Authorization: Bearer $TOKEN"

3. List some students

curl 'https://api.partners.thecareeros.com/v1/students?limit=50&order=last_name.asc' \
  -H "Authorization: Bearer $TOKEN"

4. Filter

Any column can be a filter — this is the 2026 graduating class:

curl 'https://api.partners.thecareeros.com/v1/students?graduation_date=gte.2026-01-01&graduation_date=lte.2026-12-31&limit=100' \
  -H "Authorization: Bearer $TOKEN"

The full operator set (patterns, IN-lists, OR groups, array-contains) is in the Filtering & pagination guide.

5. Explore the rest

• Nine resources are live — students, cohorts, campuses, resumes, student profiles, onboarding, alumni, jobs, universities. Browse them in the API reference, where you can also run requests against your own data directly from the browser.
• Building a typed integration? Generate a client from the OpenAPI spec.
• Coming from Symplicity? The migration guide maps the differences.