YourTradebase API
YourTradebase is a trade business management platform that helps builders, electricians, plumbers, and other tradespeople win work, organise jobs, and get paid faster. With no public API, an unofficial API lets you programmatically pull quotes, jobs, invoices, payments, customers, and schedules—and push updates like new quotes, job sheets, and invoices back into YourTradebase.
What is YourTradebase?
YourTradebase is a trade-focused business management platform that helps tradespeople streamline the paperwork and admin behind running a job. Builders, electricians, plumbers, landscapers, carpenters, and decorators use it to win more work with professional quotes, organise jobs and team schedules, track job sheets in the field, and get paid faster through one-click invoicing, automated reminders, and online card payments. The platform centres on three workflows—win work, organise jobs, and get paid—and connects to QuickBooks, Xero, and iOS and Android mobile apps.
Core product modules include:
- Quoting & Estimates (professional quote templates with pre-built pricing)
- Job Scheduling (team schedules, task management, and job timings)
- Job Sheets (digital job documentation tracked in the field)
- Invoicing (one-click invoice generation with automatic payment reminders)
- Card Payments (online card payment processing direct from invoices)
- Lead Management & Job Pipeline (lead tracking, messaging, and visual job organisation)
Common data entities:
- Quotes, Estimates, Pricing Items
- Jobs, Projects, Job Sheets, Tasks
- Invoices, Payments, Card Transactions
- Customers, Contacts, Communication History
- Leads, Schedules, Team Assignments
The YourTradebase Integration Challenge
Trade businesses run their entire back office on YourTradebase, but the operational data it holds is locked behind an end-user web and mobile product with no public API:
- No public API or developer documentation: YourTradebase is built for tradespeople, not integrators—there is no published REST API, OAuth app registration, or developer portal to build against
- Mobile-first field data: job sheets, photos, and on-site updates flow through the iOS and Android apps, so much of the operational record never touches a documented web endpoint
- Accounting connectors only: built-in QuickBooks and Xero links move invoices one direction—they don't expose your quotes, jobs, schedules, or pipeline to your own systems
- No webhooks or event feeds: there is no way to subscribe to quote-accepted, job-completed, or invoice-paid events to drive downstream automation
- Manual export ceilings: getting data out means CSV exports or copy-paste, which doesn't scale for reporting, multi-system sync, or AI workflows
- Session-based authentication: access is gated by an interactive login session rather than API keys, complicating any headless or scheduled automation
How Supergood Creates YourTradebase APIs
Supergood reverse-engineers YourTradebase's authenticated web and mobile flows to deliver a resilient, REST-style API over your own account data—no public API required. You integrate once against normalized objects for quotes, jobs, invoices, payments, customers, and schedules.
- Handles session-based login and any MFA securely in a managed, encrypted session
- Maintains session continuity with automatic refresh and change detection
- Normalizes responses across quotes, jobs, invoices, and payments so you integrate once against consistent objects
- Surfaces both web and mobile-originated data—including field job sheets—through a single API surface
Use YourTradebase with AI agents: YourTradebase MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm the YourTradebase modules, data entities, and authentication model you need.
- Supergood Generates and Validates Your API
We deliver a production-ready YourTradebase API tailored to your account, with full coverage of quotes, jobs, invoices, and payments.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adaptation as YourTradebase evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a YourTradebase account using session-based login and obtain a session token for downstream calls.
Quotes
/quotesList quotes and estimates with filters for status, customer, and date range, including line items and pricing.
Quotes
/create_quoteCreate a new quote or estimate for a customer with line items, pricing, and template selection.
Jobs
/jobsRetrieve jobs and job sheets with schedule, team assignment, task, and completion status.
Invoicing
/invoicesPull invoices, payment status, and card transactions across paid, outstanding, and overdue states.
Invoicing
/create_invoiceGenerate an invoice against a job or quote and trigger payment reminders and online card payment collection.
Use Cases
Sync quotes, jobs, and invoices into your warehouse
- Pull quotes, jobs, and invoices from YourTradebase into a single data warehouse - Stream quote-accepted and invoice-paid activity to downstream BI and reporting tools - Reconcile customer and contact records across YourTradebase and your CRM
Automate quote-to-invoice workflows
- Push new quotes into YourTradebase from your CRM or website lead forms - Convert accepted quotes into scheduled jobs without manual re-entry - Generate invoices from completed jobs and trigger automated payment reminders
Unify field and office data
- Surface mobile-originated job sheets, photos, and on-site notes through one API - Sync team schedules and task completion to workforce and dispatch tools - Keep office reporting in step with what crews record in the field
Reconcile payments and cash flow
- Sync invoices, payments, and card transactions into accounting and AR systems - Surface overdue invoices to retention and chase-up workflows - Match online card payments against jobs and customers for cash-flow reporting
Technical Specifications
Authentication
Session-based login and any MFA handled in a managed, encrypted session
Connectivity
Authenticated web and mobile flows reverse-engineered into a REST-style API surface
Response format
Normalized JSON across Quotes, Jobs, Invoices, Payments, and Customer objects
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, re-login handling, and credential rotation
Data freshness
Near real-time pulls for quotes, jobs, and invoices with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for quote accepted, job completed, and invoice paid changes
Latency
Sub-second reads on cached entities; multi-second writes when posting quotes and invoices
Throughput
Horizontally scaled workers sized to multi-job, multi-crew trade volume
Reliability
Retry, backoff, and idempotency keys for quote, job, and invoice writes
Adaptation
Continuous monitoring of YourTradebase web and mobile changes with automatic adjustment
Frequently asked questions
No. YourTradebase is built for tradespeople and does not publish a REST API, developer portal, or webhooks. Supergood creates an API over your own account data by working through YourTradebase's authenticated web and mobile flows.
Yes. Job sheets, photos, and on-site updates entered through the iOS and Android apps are surfaced through the same normalized API as web data, so field and office records sit together.
The built-in accounting connectors only push invoices into QuickBooks or Xero. Supergood exposes the full breadth of your YourTradebase data—quotes, jobs, schedules, pipeline, and payments—to any system you choose, in both directions.
Access is gated by an interactive login session rather than API keys. Supergood manages that login, MFA, and session continuity in an encrypted, automated session so your integrations run headless.
Yes. Beyond reads, the API supports creating quotes, jobs, and invoices and triggering payment workflows, with retries and idempotency keys to keep writes safe.