Skip to main content
Pick your path.

​
1. Get a sandbox key

Email your point of contact at Parlay or use the signup form. You’ll receive a key prefixed pk_sandbox_….

​
2. Submit a mock analysis

Mock fixture URLs are deterministic test data. Free, instant, no real audio required.
curl -X POST https://parlay-api-dev-o7nogixtqq-uc.a.run.app/v1/analyses \
  -H "Authorization: Bearer pk_sandbox_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "org_id": "demo-acme",
    "rep_id": "alex-smith",
    "recording_url": "mock://perfect-pitch"
  }'
You get back a 202 with { id, status: "queued", created_at }.

​
3. Poll until complete

curl https://parlay-api-dev-o7nogixtqq-uc.a.run.app/v1/analyses/<id> \
  -H "Authorization: Bearer pk_sandbox_YOUR_KEY"
status will be queued → processing → completed. Mock fixtures usually complete in under a second; real audio takes 30–90 seconds. The full analysis JSON sits in the analysis field once status === "completed".
Production integrations should use webhooks instead of polling. See the webhooks guide.

​
4. Read the result

A completed analysis includes:
  • analysis.scores — 6-pillar scoring (clarity, influence, objection, discovery, delivery, close), each 0–100
  • analysis.feedback — per-pillar positive + negative observations
  • analysis.action_plan — double-down + general improvement + quoted principle
  • analysis.kpis — words-per-minute, filler-word count, questions asked
  • transcript — full call transcript with timestamps
  • duration_seconds — call length

​
5. Real audio

Replace mock://perfect-pitch with a publicly reachable HTTPS URL to an MP3, WAV, M4A, or FLAC file. Pre-signed S3 / GCS URLs are fine. The file must not require additional auth headers.

​
You’re integrated. What’s next?

Use real audio

Submit your own recordings, configure org defaults

Set up webhooks

Stop polling — get notified when analyses complete

Generate playbooks with AI

Turn call notes into structured playbooks

Rep intelligence

Persona, methodology, and synthesis at scale