Public REST API

Portfolio API

A fully open, no-auth REST API powering this portfolio. Every work item, organization, skill, and timeline event is queryable — no key needed.

Open API ↗

Base URLhttps://api.jossscholten.com

curl example

$ curl https://api.jossscholten.com/timeline

[
  {
    "kind": "work",
    "title": "Senior Product Manager",
    "slug": "senior-pm",
    "role": "Product Lead",
    "start_year": 2021,
    "end_year": null,
    "org_name": "Acme Corp",
    "org_type": "startup"
  },
  {
    "kind": "event",
    "title": "Moved to Portland, OR",
    "type": "milestone",
    "start_year": 2022,
    "end_year": null
  }
]

What is this?

The Portfolio API is a read-only REST API that exposes structured data about my career, projects, skills, and organizations. It's the backend for this site, but it's open for anyone to query — no API key, no rate limiting on reasonable use.

No auth requiredAll endpoints are publicly readable. Just send a GET request.

JSON everywhereEvery response is JSON. No XML, no wrapping envelope — just the data.

Linked resourcesWork items link to orgs, skills, technologies, and tags by slug.

Built with Express + PostgresDeployed on Railway. Schema available on request.

Endpoints

Work

GET

/workList all work items with top outcomes, tags, and hero image

GET

/work/{slug}Full work detail — media, outcomes, skills, technologies, tags

Organizations

GET

/organizationsList all organizations

GET

/organizations/{slug}Org detail with aggregated skills, technologies, and work

Timeline

GET

/timelineWork items and life events merged, sorted by end year

Skills & Technologies

GET

/skillsAll skills grouped by category (technical, domain, leadership)

GET

/skills/{slug}Skill detail with demonstrated/developed work evidence

GET

/technologiesList of all technologies

GET

/technologies/{slug}Technology detail with associated work

Tags & Arcs

GET

/tags/{slug}Tag detail with associated work items

GET

/arcsCareer narrative arcs

GET

/arcs/{slug}Arc detail with work items

Try it

GET/work

Resources

Browse the APIExplore endpoints directly in your browser or with any HTTP client.

Open ↗

Postman CollectionA pre-built collection covering all endpoints — coming soon.

Soon

Full DocumentationDetailed field-level docs with example responses — coming soon.

Soon