Open specifications

Foliyo Resume Spec

Version 0.1.0 · Schema /spec/resume/v1.json · File extension .fio

A structured, open, human-readable resume format any ATS can consume without parsing a PDF. Brand: Foliyo (foliyo.dev) — not related to the FOLIO library platform.

Three layers

  1. Data spec — JSON document (resume.json)
  2. File format — .fio ZIP (JSON + signature + optional assets)
  3. Status API — ATS → candidate application updates

.fio package

name.fio
├── manifest.json
├── resume.json
└── signature.sig
ArtifactMedia type
Bare JSONapplication/vnd.foliyo.resume+json
.fio ZIPapplication/vnd.foliyo.resume+zip

Integrity

Signatures use HMAC-SHA256 over the SHA-256 of canonical resume.json, keyed by the issuer’s integrity secret.

  • Live verify: GET https://foliyo.dev/v1/verify/:share_token
  • Offline verify: POST https://foliyo.dev/v1/verify with resume JSON + signature payload

Status API

POST https://foliyo.dev/v1/status/notify — requires Bearer ATS API key, X-Foliyo-Signature (HMAC of raw body), and X-Foliyo-Timestamp.

Standard statuses include application_received, viewed, shortlisted, interview_scheduled, offer_extended, hired, rejected, withdrawn, on_hold.

Candidates can also track applications manually in the Foliyo dashboard without any ATS.

Downloads

Versioning

  • Document $version is SemVer
  • Breaking shape changes → new schema path (/resume/v2)

Source of truth also lives in the OSS monorepo under specs/resume/. License: MIT.

← All specs · Docs