Planday

Planday is a workforce management platform for shift-based businesses in hospitality, retail, healthcare, hotels, entertainment, and fitness, offering employee scheduling, time tracking and punch clock, absence and leave management, payroll reporting, staff communication, and HR. Planday (part of Xero) publishes a public REST/OAuth2 developer API at openapi.planday.com, organized into domains such as HR, Absence, Pay, Payroll, Portal, Punchclock, Reports, Revenue, Schedule, Contract Rules, and Security Group Membership, so partners and customers can sync employees, shifts, timesheets, pay rates, and cost data with external systems.

Planday publishes 1 API on the APIs.io network. Tagged areas include Company, SaaS, Workforce Management, Scheduling, and Time Tracking.

Planday’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 17 more developer resources.

🌐 Visit website 📡 Source on GitHub
34.0/100 thin ▬ flat Agent 25/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
1 APIs 1 MCP Servers
CompanySaaSWorkforce ManagementSchedulingTime TrackingPayrollHuman ResourcesHospitalityRetailRESTOAuth2

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 34.0/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 10.5 / 20
Operational Transparency 2.1 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 25/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/planday: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Planday API

Planday's REST API secured by OAuth2 bearer tokens, separated into domains (HR, Absence, Pay, Payroll, Portal, Punchclock, Reports, Revenue, Schedule, Contract Rules, Security G...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

planday-mcp.yml

MCP SERVER

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Planday Authentication

oauth2/openIdConnect · 2 schemes

SECURITY

Planday Domain Security

TLSv1.3 · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Planday Scopes

78 scopes · authorizationCode/clientCredentials/refreshToken

78 scopes

SCOPES

Resources

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp
 Login
Login

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

WellKnown
WellKnown
 MCPServer
MCPServer
 LLMsTxt
LLMsTxt

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 Lifecycle
Lifecycle
 Conventions
Conventions
 DataModel
DataModel

Access & Security 4

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes
 Compliance
Compliance

Operate 3

Status, limits, changes, and where to get help

Support
Support
 HelpCenter
HelpCenter
 StatusPage
StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: planday
name: Planday
description: Planday is a workforce management platform for shift-based businesses in hospitality, retail, healthcare, hotels,
  entertainment, and fitness, offering employee scheduling, time tracking and punch clock, absence and leave management, payroll
  reporting, staff communication, and HR. Planday (part of Xero) publishes a public REST/OAuth2 developer API at openapi.planday.com,
  organized into domains such as HR, Absence, Pay, Payroll, Portal, Punchclock, Reports, Revenue, Schedule, Contract Rules,
  and Security Group Membership, so partners and customers can sync employees, shifts, timesheets, pay rates, and cost data
  with external systems.
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://www.planday.com/favicon.ico
url: https://raw.githubusercontent.com/api-evangelist/planday/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- creandum
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- SaaS
- Workforce Management
- Scheduling
- Time Tracking
- Payroll
- Human Resources
- Hospitality
- Retail
- REST
- OAuth2
apis:
- name: Planday API
  description: Planday's REST API secured by OAuth2 bearer tokens, separated into domains (HR, Absence, Pay, Payroll, Portal,
    Punchclock, Reports, Revenue, Schedule, Contract Rules, Security Group Membership). Requests and responses are JSON; most
    list endpoints paginate at 50 records per page. Calls require an Authorization bearer token plus the app's X-ClientId
    header.
  humanURL: https://openapi.planday.com/
  baseURL: https://openapi.planday.com
  tags:
  - Workforce Management
  - Scheduling
  - HR
  - Payroll
  properties:
  - type: Documentation
    url: https://openapi.planday.com/gettingstarted/overview/
  - type: APIReference
    url: https://openapi.planday.com/api/absence/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DomainSecurity
  url: security/planday-domain-security.yml
- type: DeveloperPortal
  url: https://openapi.planday.com/
- type: Documentation
  url: https://openapi.planday.com/gettingstarted/overview/
- type: APIReference
  url: https://openapi.planday.com/api/absence/
- type: GettingStarted
  url: https://openapi.planday.com/gettingstarted/overview/
- type: Support
  url: https://help.planday.com/
- type: HelpCenter
  url: https://support.planday.com/
- type: Blog
  url: https://www.planday.com/resources/articles/
- type: StatusPage
  url: https://status.planday.com/
- type: Pricing
  url: https://www.planday.com/pricing/
- type: SignUp
  url: https://signup.planday.com/
- type: Login
  url: https://id.planday.com/findCompanyUrl
- type: TermsOfService
  url: https://www.planday.com/legal/
- type: PrivacyPolicy
  url: https://www.planday.com/legal/
- type: WellKnown
  url: well-known/planday-well-known.yml
- type: Authentication
  url: authentication/planday-authentication.yml
- type: OAuthScopes
  url: scopes/planday-scopes.yml
- type: Conformance
  url: conformance/planday-conformance.yml
- type: Compliance
  url: https://www.planday.com/
- type: Lifecycle
  url: lifecycle/planday-lifecycle.yml
- type: Conventions
  url: conventions/planday-conventions.yml
- type: DataModel
  url: data-model/planday-data-model.yml
- type: MCPServer
  url: mcp/planday-mcp.yml
- type: LLMsTxt
  url: llms/planday-llms.txt
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 11
  pass: local-v1