# HumMatch Partner API API

**Canonical:** https://apis.io/apis/hummatch-me/hummatch-partner-api-api/  
**Provider:** HumMatch — https://apis.io/providers/hummatch-me/  
**Base URL:** https://hummatch.me/api  
**Documentation:** https://hummatch.me/openapi.yaml

HumMatch Partner API API is one of 2 APIs that [HumMatch](https://apis.io/providers/hummatch-me/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

A partner-facing API over HumMatch's real vocal-range and song-matching logic: normalize a singer's vocal profile, score how well a specific catalog song fits that profile, and find shared-range song candidates for a small group. Every endpoint here is stateless computation over caller-submitted dat

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/sandbox-key` | Instantly issue a sandbox API key |
| POST | `/v1/vocal-profile` | Normalize a vocal range or hum-feature profile |
| GET | `/v1/songs/{slug}/fit` | Score one catalog song against a vocal profile |
| POST | `/v1/group-fit` | Find shared-range song candidates for multiple singers |
| POST | `/v1/recommendations` | Rank the catalog for one singer |
| GET | `/v1/songs/search` | Search the catalog and resolve slugs |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/hummatch-me/openapi/_original/hummatch-me-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hummatch-me/json-schema/hummatch-me-scored-song-schema.json
- **JSONSchema** — https://artifacts.apis.io/hummatch-me/json-schema/hummatch-me-vocal-profile-schema.json
- **JSONSchema** — https://artifacts.apis.io/hummatch-me/json-schema/hummatch-me-group-fit-schema.json
- **JSONSchema** — https://artifacts.apis.io/hummatch-me/json-schema/hummatch-me-song-fit-schema.json
- **JSONSchema** — https://artifacts.apis.io/hummatch-me/json-schema/hummatch-me-hum-profile-input-schema.json

## Other HumMatch APIs (1)

- [HumMatch Partner API](https://apis.io/apis/hummatch-me/hummatch-partner-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hummatch-me/hummatch-partner-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hummatch-me/.