PineappleMusicLab Business APIA REST API for businesses that want to integrate the PineappleMusicLab piano fingering pipeline into their own products. Fingering generation is asynchronous: submit a score, then either poll for job status or receive a webhook when the job completes.Endpoints

POST /api/v1/business/fingering/generate — submit a MusicXML or PDF score. Returns 202 Accepted with a job id.

GET /api/v1/business/fingering/status/{job_id} — poll job status and get a fresh download URL for the result.

GET /api/v1/business/fingering/jobs — list recent jobs.

AuthenticationRequests are authenticated with an API key sent in the X-API-Key header. Business accounts generate API keys from the pricing page.Formats and limits

Accepted input formats: MusicXML (.xml, .musicxml, .mxl) and PDF.

Output format: MusicXML with fingerings embedded in the notations/technical/fingering elements.

Business jobs process full-length scores, up to 300 measures or systems.

For single-staff scores, pass the hand query parameter as right or left.

Processing time for PDF inputs is typically longer than MusicXML, since the file must be transcribed before fingerings are generated.

Webhooks and billingConfigure a default webhook URL and secret to receive a fingering.completed event when a job finishes. Webhook requests carry the secret as a bearer token. Business usage is billed per generation with usage-based metered billing.

Home
Pricing
Tutorial
Business API
Support
Privacy Policy
Terms of Service