handy website screenshot

handy

Handy is a home-services marketplace, now part of Angi (ANGI Homeservices), that connects customers with pre-screened independent professionals for house cleaning, handyman work, furniture assembly, and in-home installations. Handy's Partner API lets retailers offer fixed-price installation and service bookings at eCommerce or in-store checkout: partners create and manage orders, products, and line items, retrieve bookings and their assigned providers, and receive booking-lifecycle webhooks. Requests are authenticated with a custom RSA-SHA256 signed-request scheme.

handy publishes 4 APIs on the APIs.io network, including Bookings API, Order Products API, Orders API, and 1 more. Tagged areas include Company, Home Services, Marketplace, Cleaning, and Handyman.

The handy catalog on APIs.io includes 1 event-driven AsyncAPI specification.

handy’s developer surface includes documentation, API reference, support, authentication, sandbox, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
44.6/100 thin ▬ flat Agent 78/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
4 APIs 1 MCP Servers
CompanyHome ServicesMarketplaceCleaningHandymanInstallationsOn-DemandGig EconomyOrdersWebhooksRetailAngi

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 44.6/100 · thin
Contract Quality 15.1 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 4.2 / 20
Operational Transparency 3.1 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 78/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 3 / 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/handy: 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 4

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

handy Bookings API

The Bookings API from handy — 1 operation(s) for bookings.

handy Order Products API

The Order Products API from handy — 2 operation(s) for order products.

handy Orders API

The Orders API from handy — 2 operation(s) for orders.

handy Testing API

The Testing API from handy — 1 operation(s) for testing.

MCP Servers 1

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

handy-mcp.yml

MCP SERVER

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Handy Webhooks

ASYNCAPI

Security Posture 3

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

Handy Authentication

signed-request · 1 scheme

SECURITY

Handy Domain Security

TLSv1.2 · HSTS · DMARC

SECURITY

Handy Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Handy Agentic Access

10 operations · 6 acting

10 operations · 6 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 Sandbox
Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCPServer
MCPServer
 AgentSkill
AgentSkill
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 DataModel
DataModel
 Conformance
Conformance
 Webhooks
Webhooks

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

Authentication
Authentication
 SecurityTxt
SecurityTxt
 Security
Security
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
aid: handy
name: handy
description: 'Handy is a home-services marketplace, now part of Angi (ANGI Homeservices), that connects customers with pre-screened
  independent professionals for house cleaning, handyman work, furniture assembly, and in-home installations. Handy''s Partner
  API lets retailers offer fixed-price installation and service bookings at eCommerce or in-store checkout: partners create
  and manage orders, products, and line items, retrieve bookings and their assigned providers, and receive booking-lifecycle
  webhooks. Requests are authenticated with a custom RSA-SHA256 signed-request scheme.'
url: https://raw.githubusercontent.com/api-evangelist/handy/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- slow-ventures
x-tier: active
x-tier-reason: partner-api-enriched
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-19'
image: https://www.handy.com/favicon.ico
tags:
- Company
- Home Services
- Marketplace
- Cleaning
- Handyman
- Installations
- On-Demand
- Gig Economy
- Orders
- Webhooks
- Retail
- Angi
apis:
- aid: handy:handy-bookings-api
  name: handy Bookings API
  description: The Bookings API from handy — 1 operation(s) for bookings.
  humanURL: https://partners.services.handy.com/docs/orders_api
  baseURL: https://partners.services.handy.com/api/v1
  tags:
  - Bookings
  properties:
  - type: OpenAPI
    url: openapi/handy-bookings-api-openapi.yml
  - type: APIReference
    url: https://partners.services.handy.com/docs/orders_api
  - type: Documentation
    url: https://partners.services.handy.com/docs/orders_api
  - type: Webhooks
    url: asyncapi/handy-webhooks.yml
- aid: handy:handy-order-products-api
  name: handy Order Products API
  description: The Order Products API from handy — 2 operation(s) for order products.
  humanURL: https://partners.services.handy.com/docs/orders_api
  baseURL: https://partners.services.handy.com/api/v1
  tags:
  - Order Products
  properties:
  - type: OpenAPI
    url: openapi/handy-order-products-api-openapi.yml
  - type: APIReference
    url: https://partners.services.handy.com/docs/orders_api
  - type: Documentation
    url: https://partners.services.handy.com/docs/orders_api
  - type: Webhooks
    url: asyncapi/handy-webhooks.yml
- aid: handy:handy-orders-api
  name: handy Orders API
  description: The Orders API from handy — 2 operation(s) for orders.
  humanURL: https://partners.services.handy.com/docs/orders_api
  baseURL: https://partners.services.handy.com/api/v1
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/handy-orders-api-openapi.yml
  - type: APIReference
    url: https://partners.services.handy.com/docs/orders_api
  - type: Documentation
    url: https://partners.services.handy.com/docs/orders_api
  - type: Webhooks
    url: asyncapi/handy-webhooks.yml
- aid: handy:handy-testing-api
  name: handy Testing API
  description: The Testing API from handy — 1 operation(s) for testing.
  humanURL: https://partners.services.handy.com/docs/orders_api
  baseURL: https://partners.services.handy.com/api/v1
  tags:
  - Testing
  properties:
  - type: OpenAPI
    url: openapi/handy-testing-api-openapi.yml
  - type: APIReference
    url: https://partners.services.handy.com/docs/orders_api
  - type: Documentation
    url: https://partners.services.handy.com/docs/orders_api
  - type: Webhooks
    url: asyncapi/handy-webhooks.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: AgenticAccess
  url: agentic-access/handy-agentic-access.yml
- type: DeveloperPortal
  url: https://partners.services.handy.com/docs/orders_api
- type: Documentation
  url: https://partners.services.handy.com/docs/orders_api
- type: APIReference
  url: https://partners.services.handy.com/docs/orders_api
- type: GitHubOrganization
  url: https://github.com/Handybook
- type: Support
  url: https://help.handy.com/
- type: TermsOfService
  url: https://www.handy.com/terms
- type: PrivacyPolicy
  url: https://www.handy.com/privacy
- type: Authentication
  url: authentication/handy-authentication.yml
- type: Conventions
  url: conventions/handy-conventions.yml
- type: ErrorCatalog
  url: errors/handy-problem-types.yml
- type: Lifecycle
  url: lifecycle/handy-lifecycle.yml
- type: DataModel
  url: data-model/handy-data-model.yml
- type: Conformance
  url: conformance/handy-conformance.yml
- type: Sandbox
  url: sandbox/handy-sandbox.yml
- type: Webhooks
  url: asyncapi/handy-webhooks.yml
- type: MCPServer
  url: mcp/handy-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/handy-llms.txt
- type: Overlay
  url: overlays/handy-orders-overlay.yaml
- type: WellKnown
  url: well-known/handy-well-known.yml
- type: SecurityTxt
  url: well-known/handy-security.txt
- type: Security
  url: https://www.handy.com/.well-known/security.txt
- type: VulnerabilityDisclosure
  url: security/handy-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/handy-domain-security.yml
- type: Website
  url: https://handy.com
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence