Search the documentation, browse by topic, or pick a guide below.
Your STP overview at a glance — track employers, employees, and submission status.
Set up and manage employer entities for STP reporting.
Add and manage employee records for STP pay reporting.
Create and manage pay events for STP submission to the ATO.
Track your STP submissions and ATO responses.
Review a complete audit trail of all actions taken in the system.
Lodge the end-of-financial-year finalisation event with the ATO.
View year-to-date payroll totals for each employee.
What the Beeswax STP API is, what it isn't, and how to decide if it's right for you.
Zero to first ATO lodgement in under 10 minutes. Copy-paste curl commands included.
Bearer token authentication, test vs live tokens, scopes, and security best practices.
How test and live environments work, how the API decides which one you're in, and how to switch safely.
One-shot endpoint that provisions a test employer + sample employees so you can exercise the API in under a minute.
HTTP status codes, error response shape, error codes, and handling guidance.
Per-token rate limits, response headers, and backoff strategies.
How list endpoints paginate, query parameters, and response headers.
Make retries safe with the Idempotency-Key header.
Receive real-time callbacks from Beeswax STP when submissions change state.
Receive signed callbacks from Beeswax STP when submissions change state. No more polling.
Browse and replay webhook events you may have missed.
Create, manage, and revoke API tokens from the web UI.
Manage employer (ABN) records via the API.
Manage employee records under an employer.
Create pay events, add line items, and submit to the ATO.
Inspect the state of submissions you've sent to the ATO.
How Tax File Numbers and other sensitive employee data travel over the Beeswax STP API — the transport contract, storage model, and what we guarantee.
Year-to-date running totals per employee per financial year.
All the ATO STP Phase 2 codes you'll need — income types, employment basis, cessation reasons, tax treatment codes.
Commercial and technical onboarding for fintechs, payroll software, and platform partners integrating Beeswax STP as an ATO lodgement backend.
Manage your subscription, change plan, update payment method.
Manage your profile, security settings, and application configuration.
Set up and manage two-factor authentication (MFA) for your account.