Demiton · Schema

employee_list contract v1

Employees registered in your payroll system.

CompanyConstructionCivil EngineeringProject ManagementComplianceMCPArtificial IntelligenceOpen Contracting

Properties

Name	Type	Description
tags	array	Tenant-assigned labels on the employee record
email	string	Work/contact email used as an identity bridge
title	string	Honorific or name prefix
gender	string	Gender, for diversity aggregation
job_title	string	Role/job title at the employer
given_name	string	First/given name as a separate part
work_types	string	Tenant work-type assignment
family_name	string	Surname/family name as a separate part
display_name	string	The worker's display name
date_of_birth	string	Worker date of birth
employment_type	string	The engagement basis
legal_entity_id	integer	The employing legal entity, resolved per record
worker_entity_id	integer	Demiton canonical worker spine node this fact anchors to (the subject)
employment_status	string	Current employment state
source_created_at	string	When the source record was created (freshness)
source_external_id	string	The raw record id in the producing system
employment_end_date	string	Date the engagement ended, where known
employment_agreement	string	Tenant award/agreement name the employee is paid under
employment_start_date	string	Date the employment relationship started
reporting_dimension_values	string	Tenant reporting-dimension assignment

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/employee_list/v1.json",
  "title": "employee_list contract v1",
  "type": "object",
  "required": [
    "display_name",
    "employment_start_date",
    "employment_type",
    "source_external_id",
    "worker_entity_id"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "description": "Tenant-assigned labels on the employee record",
      "x-demiton-requiredness": "tenant-specific"
    },
    "email": {
      "type": "string",
      "description": "Work/contact email used as an identity bridge",
      "x-demiton-requiredness": "optional"
    },
    "title": {
      "type": "string",
      "description": "Honorific or name prefix",
      "x-demiton-requiredness": "optional"
    },
    "gender": {
      "type": "string",
      "description": "Gender, for diversity aggregation",
      "x-demiton-requiredness": "optional"
    },
    "job_title": {
      "type": "string",
      "description": "Role/job title at the employer",
      "x-demiton-requiredness": "optional"
    },
    "given_name": {
      "type": "string",
      "description": "First/given name as a separate part",
      "x-demiton-requiredness": "optional"
    },
    "work_types": {
      "type": "string",
      "description": "Tenant work-type assignment",
      "x-demiton-requiredness": "tenant-specific"
    },
    "family_name": {
      "type": "string",
      "description": "Surname/family name as a separate part",
      "x-demiton-requiredness": "optional"
    },
    "display_name": {
      "type": "string",
      "description": "The worker's display name",
      "x-demiton-requiredness": "required"
    },
    "date_of_birth": {
      "type": "string",
      "description": "Worker date of birth",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "employment_type": {
      "type": "string",
      "description": "The engagement basis",
      "x-demiton-requiredness": "required"
    },
    "legal_entity_id": {
      "type": "integer",
      "description": "The employing legal entity, resolved per record",
      "x-demiton-requiredness": "optional"
    },
    "worker_entity_id": {
      "type": "integer",
      "description": "Demiton canonical worker spine node this fact anchors to (the subject)",
      "x-demiton-requiredness": "required"
    },
    "employment_status": {
      "type": "string",
      "description": "Current employment state",
      "x-demiton-requiredness": "optional"
    },
    "source_created_at": {
      "type": "string",
      "description": "When the source record was created (freshness)",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "source_external_id": {
      "type": "string",
      "description": "The raw record id in the producing system",
      "x-demiton-requiredness": "required"
    },
    "employment_end_date": {
      "type": "string",
      "description": "Date the engagement ended, where known",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "employment_agreement": {
      "type": "string",
      "description": "Tenant award/agreement name the employee is paid under",
      "x-demiton-requiredness": "tenant-specific"
    },
    "employment_start_date": {
      "type": "string",
      "description": "Date the employment relationship started",
      "x-demiton-requiredness": "required",
      "format": "date",
      "x-demiton-type": "date"
    },
    "reporting_dimension_values": {
      "type": "string",
      "description": "Tenant reporting-dimension assignment",
      "x-demiton-requiredness": "tenant-specific"
    }
  },
  "x-demiton-register-type": "employee_list",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "ATO tax file number declaration",
        "title": "Tax file number and withholding declarations - kept with employee records",
        "access": "public_summary",
        "region": "Australia",
        "edition": "ATO guidance updated 11 Jun 2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Fair Work Act 2009 (Cth)",
        "title": "Fair Work Act 2009 - employee records and National Employment Standards",
        "access": "full_text_verified",
        "clause": "ss.87(1), 96(1), 535",
        "region": "Australia",
        "edition": "compilation 2026-07-07",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Fair Work Regulations 2009 (Cth)",
        "title": "Fair Work Regulations 2009 - employee record content",
        "access": "full_text_verified",
        "clause": "reg 3.32",
        "region": "Australia",
        "edition": "compilation 2026-06-20",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles; employee-records exemption; health information s.6FA",
        "access": "public_summary",
        "region": "Australia",
        "edition": "current",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Single Touch Payroll Phase 2 (ATO)",
        "title": "Single Touch Payroll Phase 2 employer reporting guidelines",
        "access": "public_summary",
        "region": "Australia",
        "edition": "Phase 2 (mandatory from 1 Jan 2022)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Regulation (EU) 2016/679 (GDPR)",
        "title": "General Data Protection Regulation",
        "access": "full_text_verified",
        "region": "European Union",
        "edition": "2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 30414:2025",
        "title": "Human resource management - Requirements and recommendations for human capital reporting and disclosure",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2nd ed. 2025 (supersedes ISO 30414:2018)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Employment Leave Act 2026 (NZ)",
        "title": "Employment Leave Act 2026 (2026 No 48)",
        "access": "full_text_verified",
        "clause": "ss.6-8",
        "region": "New Zealand",
        "edition": "assent 6 Aug 2026; not yet in force",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 2020 (NZ)",
        "title": "Privacy Act 2020 and Health Information Privacy Code 2020",
        "access": "public_summary",
        "region": "New Zealand",
        "edition": "Act 2020; HIPC version as at 1 May 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "HMRC Real Time Information (RTI)",
        "title": "PAYE Real Time Information - Full Payment Submission and Employer Payment Summary",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "guidance updated 6 Apr 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "UK GDPR",
        "title": "UK GDPR and Data Protection Act 2018",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "current",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Employees registered in your payroll system.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/employee_list/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/demiton-io-employee_list-v1"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.