Skip to main content
POST
Submit Number Draft
Requires an account-owned live API key with an associated user. Send an empty JSON object {}. The request must be a customer-owned editable draft; agent-prepared or hosted-site drafts require owner completion in Trackly. New submissions require a paid account or an approved billing bypass, plus a current API-key owner with a verified email. Free accounts and owners awaiting email verification can still save and confirm inert drafts. Ineligible submission returns 403 paid_plan_required or 403 email_verification_required; a missing or deleted key owner returns 403 api_key_has_no_owner. The server validates all request fields and atomically rechecks the exact business binding, current revision, accepted evidence, expiry, and account holds before admitting submission. A successful response is 200 with the same request id and status: "pending". Repeated submission of that same already-pending request returns 200 without sending duplicate pending-review notifications, even if the plan or owner email status has since changed. The key must still have a current associated user. Other statuses do not silently start a replacement request.

Recovering from an error

Incomplete request fields return 422. A business that is pending, expired, stale, unproven, or no longer matches the request returns its specific verification code and message; read the current request and business, complete verification, and reconfirm if required. An active operation or stale save can return 409. An uncertain submission acknowledgement returns 503 with requestId: fetch that request to reconcile its state, then retry submission on the same id if still a draft. Keep the draft id throughout this process. The one-shot create endpoint uses the same checks for clients that already have complete data and explicit customer confirmation.