Developer API Beta

How do I authenticate?

Generate a secret key in Settings → Developer API (Business plan). Send it as a Bearer token. Use the key from your own server only, never expose it in a browser or app. Calls count against your plan’s daily limits.

Base URL: https://www.nextiqumai.com/api

# every request carries your key in the Authorization header
Authorization: Bearer nx_live_xxxxxxxxxxxxxxxxxxxx

POSTHow do I create a project scope with the Mark endpoint?

/api/scope.php

Turn a plain-language project idea into a structured build plan (type, timeline, stack, phases, considerations).

curl https://www.nextiqumai.com/api/scope.php \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"description":"A booking app for dental clinics with reminders and payments."}'

POSTHow can I audit a website using the Iris endpoint?

/api/audit.php

Audit a public URL and return prioritised quick wins for SEO, UX and trust, with a score.

curl https://www.nextiqumai.com/api/audit.php \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

POSTPOST Ask a document POST Ask a document (Docs & Voice)

/api/ask.php

Answer a question strictly from text you provide, plus the document’s main points. Returns { "answer": "...", "key_points": [...] }.

curl https://www.nextiqumai.com/api/ask.php \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"context":"<your document text>","question":"What is the refund window?"}'

POSTPOST Document extract POST Document extract (Docs & Voice)

/api/extract.php · multipart/form-data

Pull structured data from a photo of an invoice, receipt, ID or form. Returns { "data": {...} }. Image up to 8 MB.

curl https://www.nextiqumai.com/api/extract.php \
  -H "Authorization: Bearer nx_live_..." \
  -F "[email protected]"

POSTPOST Voice to notes POST Voice to notes (Docs & Voice)

/api/transcribe.php · multipart/form-data

Transcribe an audio file and return a clean transcript plus a summary with action items. Length limit follows your plan.

curl https://www.nextiqumai.com/api/transcribe.php \
  -H "Authorization: Bearer nx_live_..." \
  -F "[email protected]"

POSTHow does the Loquelle recap and prep pack endpoint work?

/api/copilot.php · JSON

Two modes of the same endpoint. prep turns a brief and an optional document into a pre-call pack: likely questions with answers, points to land, questions to ask. keypoints turns a transcript into the recap Loquelle writes at the end of a call: key points, decisions, action items and a follow-up email. Each call is one run from your pool. Live suggestions during a call are not offered through the API; transcribe with the endpoint below and send the text here.

# prep pack
curl https://www.nextiqumai.com/api/copilot.php \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"mode":"prep","context":"Sales call with a Shopify brand, I am the founder","doc":"optional document text"}'

# recap from a transcript
curl https://www.nextiqumai.com/api/copilot.php \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"mode":"keypoints","context":"Weekly status, I am the project manager","transcript":"...the call, as text...","mid":"any-id-for-this-meeting"}'

# reply
{"answer":"KEY POINTS:\n- ...\nDECISIONS:\n- ...\nACTION ITEMS:\n- ...\nFOLLOW-UP EMAIL:\nSubject: ..."}

POSTHow can I transcribe an audio clip with Loquelle?

/api/copilot-audio.php · multipart/form-data

The transcription Loquelle uses live. Send audio in chunks of a few seconds (webm, ogg or m4a, 8 MB each at most) and get the text back; join the chunks and send them to keypoints above. Counts against your Loquelle minutes, not the run pool.

curl https://www.nextiqumai.com/api/copilot-audio.php \
  -H "Authorization: Bearer nx_live_..." \
  -F "[email protected]"

{"transcript":"...what was said in this chunk..."}

GETHow do I check my usage limits with the API?

/api/usage-summary.php

Your plan, the run pool (cap, used, and whether it resets daily or monthly), per-agent counts and Loquelle minutes, so a client can back off before it hits a limit instead of after.

curl https://www.nextiqumai.com/api/usage-summary.php \
  -H "Authorization: Bearer nx_live_..."

{"user":{"plan":"business",...},"pool":{"cap":5600,"used":112,"period":"month"},"agents":[...],"cue":{...}}

What are the rate limits and errors?

Each key draws on your plan’s shared run pool (Business: 5600 runs a month across Mark, Iris and Docs & Voice combined, with a burst cap of 300 in any single day). Loquelle has its own separate meeting-minute allowance. Responses are JSON. On a problem you get an { "error": "code" } with an HTTP status:

Every response to a key-authenticated request carries an X-NX-Request-Id header, and a 401 repeats it in the body. Quote it when you write to support and we can find the exact call.