SmartHR

SmartHR is a leading Japanese cloud HR, labor, and personnel management SaaS (smarthr.jp). Its per-tenant REST API exposes an organization's employee ("crew") records and the master data around them - departments, employment types, business establishments, and custom field templates - plus webhook subscriptions for change notifications. The API is served from each customer's own tenant subdomain (https://{tenant}.smarthr.jp/api) under a /v1 path, and is authenticated with a per-tenant access token passed as a Bearer token.

SmartHR publishes 6 APIs on the APIs.io network, including Business Establishments API, Crews API, Custom Field Templates API, and 3 more. Tagged areas include HR, Human Resources, HRIS, Labor Management, and Payroll.

SmartHR’s developer surface includes authentication, documentation, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub

41.2/100 thin ▬ flat Agent 48/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5

AccessFreeSelf serve⚡ Free to try

6 APIs

HRHuman ResourcesHRISLabor ManagementPayrollJapanEmployeesPersonnelOnboardingSaaS

Kin Score

Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5

Composite quality — 41.2/100 · thin

Contract Quality 14.6 / 25

Developer Ergonomics 3.9 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 4.8 / 13

Governance 0.0 / 12

Discoverability 10.0 / 10

Agent readiness — 48/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 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/smarthr: 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 6

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

Rate Limits 1

Documented rate limits and quota policies.

Smarthr Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Company 2

The organization behind the API

LinkedIn

Website

Website

Source (apis.yml)

aid: smarthr
url: https://raw.githubusercontent.com/api-evangelist/smarthr/refs/heads/main/apis.yml
name: SmartHR
kind: company
description: SmartHR is a leading Japanese cloud HR, labor, and personnel management SaaS (smarthr.jp). Its per-tenant REST
  API exposes an organization's employee ("crew") records and the master data around them - departments, employment types,
  business establishments, and custom field templates - plus webhook subscriptions for change notifications. The API is served
  from each customer's own tenant subdomain (https://{tenant}.smarthr.jp/api) under a /v1 path, and is authenticated with
  a per-tenant access token passed as a Bearer token.
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/smarthr.png
tags:
- HR
- Human Resources
- HRIS
- Labor Management
- Payroll
- Japan
- Employees
- Personnel
- Onboarding
- SaaS
created: '2026-07-12'
modified: '2026-07-12'
specificationVersion: '0.19'
apis:
- aid: smarthr:smarthr-business-establishments-api
  name: SmartHR Business Establishments API
  description: Business establishments (jigyosho) registered for the tenant.
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Business Establishments
  properties:
  - type: OpenAPI
    url: openapi/smarthr-business-establishments-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
- aid: smarthr:smarthr-crews-api
  name: SmartHR Crews API
  description: Employee ("crew") records - the core personnel objects in SmartHR.
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Crews
  properties:
  - type: OpenAPI
    url: openapi/smarthr-crews-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
- aid: smarthr:smarthr-custom-field-templates-api
  name: SmartHR Custom Field Templates API
  description: Templates defining custom fields attached to crew records.
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Custom Field Templates
  properties:
  - type: OpenAPI
    url: openapi/smarthr-custom-field-templates-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
- aid: smarthr:smarthr-departments-api
  name: SmartHR Departments API
  description: Organizational departments that crews belong to.
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Departments
  properties:
  - type: OpenAPI
    url: openapi/smarthr-departments-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
- aid: smarthr:smarthr-employment-types-api
  name: SmartHR Employment Types API
  description: Employment type master data (full-time, part-time, contract, etc.).
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Employment Types
  properties:
  - type: OpenAPI
    url: openapi/smarthr-employment-types-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
- aid: smarthr:smarthr-webhooks-api
  name: SmartHR Webhooks API
  description: Webhook subscriptions that notify external systems of changes.
  humanURL: https://developer.smarthr.jp/api
  baseURL: https://{tenant}.smarthr.jp/api
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/smarthr-webhooks-api-openapi.yml
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_api
  - type: APIReference
    url: https://developer.smarthr.jp/api
  - type: PostmanCollection
    url: collections/smarthr.postman_collection.json
  - type: OpenCollection
    url: collections/smarthr.opencollection.json
  - type: Documentation
    url: https://developer.smarthr.jp/api/about_webhook
common:
- type: AgenticAccess
  url: agentic-access/smarthr-agentic-access.yml
- type: DomainSecurity
  url: security/smarthr-domain-security.yml
- type: Authentication
  url: authentication/smarthr-authentication.yml
- type: GitHubOrganization
  url: https://github.com/kufu
- type: LinkedIn
  url: https://www.linkedin.com/company/smarthr
- type: Website
  url: https://smarthr.jp/
- type: Documentation
  url: https://developer.smarthr.jp/
- type: Plans
  url: plans/smarthr-plans-pricing.yml
- type: RateLimits
  url: rate-limits/smarthr-rate-limits.yml
- type: FinOps
  url: finops/smarthr-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

SmartHR

Kin Score

APIs 6

SmartHR Business Establishments API

SmartHR Crews API

SmartHR Custom Field Templates API

SmartHR Departments API

SmartHR Employment Types API

SmartHR Webhooks API

Open Collections 1

SmartHR API

Pricing Plans 1

Smarthr Plans Pricing

Rate Limits 1

Smarthr Rate Limits

FinOps 1

Smarthr Finops

Security Posture 2

Smarthr Authentication

Smarthr Domain Security

Agentic Access 1

Smarthr Agentic Access

Resources