Free on all plans

Rentals, dispatch, scheduling, quotes, customers, fleet map, customer portal, reviews, directory listing, Stripe Connect payments, driver app, multi-language (EN/ES/FR).

Hauler+ features

These endpoints return 403 with upgrade_url for Pickup users:

Fleet-only features

White-label branding, custom domain, custom SMTP, QuickBooks, Xero, Invoice Ninja, HubSpot, FreshBooks, and IoT integrations.

Error response

Copy// 403 Forbidden
{
  "error": "This feature requires a Hauler or Fleet plan.",
  "plan": "pickup",
  "upgrade_url": "/pricing"
}

Login flow

CopyPOST /api/auth/login
Content-Type: application/json

{
  "company_slug": "acme-hauling",
  "username":     "admin",
  "password":     "changeme123"
}

Copy// 200 OK
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id":       1,
    "username": "admin",
    "role":     "owner",
    "company_id": 1
  }
}

Using the token

CopyGET /api/rentals
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Login returns an access token (15 min) and a refresh token (30 days). Use the refresh endpoint to get a new access token without re-authenticating.

Token refresh

CopyPOST /api/auth/refresh
Content-Type: application/json

{ "refresh_token": "eyJ..." }

// Response:
{ "token": "eyJ...", "refresh_token": "eyJ..." }

Roles

Multi-tenancy

Every API request is automatically scoped to the company_id embedded in the JWT. It is impossible for one company to access another company's data through the API.

Register body

Copy{
  "company_name":   "Acme Hauling",
  "company_phone":  "555-1234",
  "company_email":  "info@acmehauling.com",
  "company_address":"123 Main St",
  "company_city":   "Sioux Falls",
  "company_state":  "SD",
  "company_zip":    "57101",
  "owner_username": "admin",
  "owner_email":    "owner@acmehauling.com",
  "owner_password": "changeme123"
}

Email verification

When a new user is created, a verification email is sent with a tokenized link. The token is valid for 24 hours. Clicking the link calls POST /api/auth/verify-email?token=XXX and renders a styled confirmation page.

CopyPOST /api/auth/resend-verification
Content-Type: application/json

{
  "email":        "jane@example.com",
  "company_slug": "acme-hauling"
}

Key rental fields

Scale weight & tonnage overages

After a dumpster is weighed at the dump, record the scale ticket weight to auto-calculate tonnage overages based on dumpster size limits.

CopyPOST /api/rentals/:id/overage
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "scale_weight": 4.2
}

The server compares scale_weight (in tons) against the included tonnage for the dumpster size. If the weight exceeds the limit, an overage charge is automatically calculated using the company's configured overage rate ($/ton) and added to the rental total.

Copy// 200 OK
{
  "overage_tons":   1.2,
  "overage_amount": 90.00,
  "scale_weight":   4.2,
  "included_tons":  3.0,
  "rate_per_ton":   75.00,
  "total_price":    465.00
}

Trailer Rentals

Dumpsters support an equipment_type field that distinguishes between traditional roll-off containers and trailers. When set to trailer, additional fields become available for vehicle and insurance tracking.

Set equipment_type when creating or updating a dumpster via POST /api/dumpsters or PATCH /api/dumpsters/:id. The GET /api/dumpsters response includes equipment_type and all trailer-specific fields.

CopyPOST /api/dumpsters
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "label": "TRL-001",
  "size": "20",
  "equipment_type": "trailer",
  "trailer_size": "20ft",
  "vehicle_reg": "ABC-1234",
  "vehicle_vin": "1HGCM82633A004352",
  "reg_number": "REG-5678",
  "insurance_provider": "National Hauler Insurance",
  "insurance_policy": "POL-99001",
  "insurance_expiry": "2027-03-15",
  "weight_capacity": 8.5
}

Driver actions

Drivers execute actions on appointments from the mobile app. Each action updates the appointment status, dumpster status, and optionally records GPS coordinates.

CopyPOST /api/appointments/:id/action
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "action": "dropped_off",
  "lat":    41.8781,
  "lng":    -87.6298
}

Proof-of-delivery photo

Upload a photo as proof of delivery or pickup. Sent as multipart form data.

CopyPOST /api/appointments/:id/proof
Authorization: Bearer eyJ...
Content-Type: multipart/form-data

photo: (binary file)

Update appointment

Update an appointment's details. Commonly used to add driver notes or change status for missed/cancelled appointments.

CopyPATCH /api/appointments/:id
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "driver_notes": "Gate code 1234, park on left side",
  "status":       "missed"
}

Supported status values for manual update: missed, cancelled.

Also see GET /api/schedule?month=YYYY-MM for a month-view calendar of all rentals.

Form types -service_type

All three embeddable forms post to the same endpoint. The service_type field distinguishes them.

POST body -dumpster quote

CopyPOST /api/quotes?company=acme-dumpsters
{
  "service_type":   "dumpster_quote",
  "customer_name":  "Jane Smith",
  "customer_email": "jane@example.com",
  "customer_phone": "555-1234",
  "size":           "20",
  "duration_type":  "week",
  "delivery_date":  "2025-07-10",
  "address":        "123 Main St, Springfield, IL",
  "promo_code":     "SAVE-AB12"
}

POST body -managed cleanup

CopyPOST /api/quotes?company=acme-dumpsters
{
  "service_type":   "managed_cleanup",
  "customer_name":  "Bob Jones",
  "customer_email": "bob@example.com",
  "customer_phone": "555-5678",
  "cleanup_type":   "estate_cleanout",
  "property_size":  "3_bedroom",
  "preferred_date": "2025-07-15",
  "details":        "3-bedroom house, lots of furniture"
}

POST body -contact us

CopyPOST /api/quotes?company=acme-dumpsters
{
  "service_type":      "contact",
  "customer_name":     "Alice Brown",
  "customer_email":    "alice@example.com",
  "customer_phone":    "555-9012",
  "contact_subject":   "billing",
  "message":           "I have a question about my last invoice."
}

Quote follow-up

Send a follow-up message to a customer who submitted a quote. The quote status is automatically set to contacted.

CopyPOST /api/quotes/:id/follow-up
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "channel": "both",
  "message": "Hi Jane, just following up on your dumpster quote. Ready to book?"
}

Pricing JSON structure

Update via PATCH /api/companies/me. Any omitted fields fall back to defaults.

Copy{
  "pricing": {
    "rental_rates": {
      "10": { "daily": 175, "weekend": 220, "week": 260, "extended": null },
      "15": { "daily": 220, "weekend": 275, "week": 315, "extended": null },
      "20": { "daily": 285, "weekend": 315, "week": 375, "extended": null },
      "30": { "daily": 350, "weekend": 400, "week": 460, "extended": null },
      "40": { "daily": 425, "weekend": 480, "week": 550, "extended": null }
    },
    "addon_fees": {
      "mattress":   30,
      "box_spring": 30,
      "tire":       10,
      "lcd_tv":     20
    },
    "included_tons": {
      "10": 1, "15": 1.5, "20": 2, "30": 3, "40": 4
    },
    "weight_fees": {
      "10": 40, "15": 48, "20": 62, "30": 75, "40": 90
    },
    "mileage": {
      "rate_per_mile": 0.70,
      "free_miles":    20
    }
  }
}

Tonnage overage calculation

When a scale weight is recorded on a rental, the overage is auto-calculated: (scale_weight - included_tons[size]) × weight_fees[size]. Only the tonnage exceeding the included amount is charged. For example, a 20 yd dumpster weighing 3.5 tons: (3.5 - 2) × $62 = $93.00 overage.

Saved reports

Query parameters

Example: revenue report

CopyGET /api/reports/revenue?from=2024-01-01&to=2024-12-31&period=month

// Response:
{
  "data": [
    { "period": "2024-01", "rental_count": 12, "gross_revenue": "4800.00", "collected_revenue": "3600.00" },
    ...
  ],
  "totals": {
    "gross_revenue": "48000.00",
    "collected_revenue": "36000.00",
    "rental_count": 120,
    "avg_rental_value": "400.00"
  },
  "from": "2024-01-01",
  "to": "2024-12-31"
}

Export response

CopyPOST /api/integrations/quickbooks/export
{ "rental_ids": [42, 43, 44] }

// Response:
{
  "results": [
    { "rental_id": 42, "qb_invoice_id": "156", "qb_doc_number": "1001", "status": "exported" },
    { "rental_id": 43, "qb_invoice_id": "157", "qb_doc_number": "1002", "status": "exported" },
    { "rental_id": 44, "status": "error", "error": "Customer not found" }
  ]
}

Setup flow

1. Company clicks Connect Stripe in the dashboard Settings page.
2. Frontend calls GET /api/billing/connect/start -receives an onboarding URL.
3. User completes Stripe Express onboarding.
4. Stripe redirects back to /api/billing/connect/return -account is marked enabled.
5. Company can now generate Payment Links on any rental.

Generate a Payment Link

CopyPOST /api/billing/connect/payment-link
Authorization: Bearer <token>
{ "rental_id": 42, "amount_cents": 35000, "description": "20yd Dumpster Rental" }

// Response:
{ "url": "https://buy.stripe.com/..." }

The link URL is stored on the rental record and displayed in the rental detail panel.

Socket.io rooms & events

Connect to wss://<host> with { auth: { token } }. The server automatically joins the socket to the company room (company:<id>) on connect.

Copy// Browser example
const socket = io('https://trashgeek.app', {
  auth: { token: localStorage.getItem('token') }
});

socket.on('message', msg => console.log('New message:', msg));
socket.on('rental_updated', rental => refreshDispatch(rental));

Usage

Add a container with class trashgeek-widget and your company slug + form type, then include the script:

Copy<!-- Dumpster Quote form -->
<div class="trashgeek-widget"
     data-company="acme-dumpsters"
     data-form="quote"></div>

<!-- Managed Cleanup request form -->
<div class="trashgeek-widget"
     data-company="acme-dumpsters"
     data-form="cleanup"></div>

<!-- Contact Us form -->
<div class="trashgeek-widget"
     data-company="acme-dumpsters"
     data-form="contact"></div>

<script src="https://trashgeek.app/widget.js"></script>

Form types

Copy embed snippets

Pre-filled snippets for all three form types are available in the dashboard under Settings → Embed Codes. Each snippet includes your company slug and a one-click copy button.

Pricing is deep-merged over built-in defaults, so you only need to specify the values you want to override.

Default rates

Default addon fees

Default mileage

Update pricing

CopyPATCH /api/companies/me
Authorization: Bearer <owner-token>

{
  "pricing": {
    "rental_rates": {
      "20": { "daily": 300, "weekend": 340, "week": 400, "extended": null }
    },
    "mileage": {
      "rate_per_mile": 0.85,
      "free_miles": 15
    }
  }
}

Seasonal rules

Package bundles

Subscription contracts

Availability & discounts

Price adjustment types

Portal chat

Portal Payments

Customers can pay invoices directly from their portal link via Stripe Checkout. Enable with portal_payments_enabled in company settings.

Create a damage report

CopyPOST /api/damage
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "rental_id":   42,
  "dumpster_id": 7,
  "description": "Cracked side panel from forklift impact",
  "severity":    "moderate",
  "repair_cost": 350.00
}

Severity levels

Upload damage photo

Attach photos to a damage report. Use the optional type field to distinguish between pre-repair and post-repair photos.

CopyPOST /api/damage/:id/photo
Authorization: Bearer eyJ...
Content-Type: multipart/form-data

photo: (binary file)
type: pre

Environment variables

Environment variables

Environment variables

Environment variables

Environment variables

Environment variables

Forum Endpoints

Listings Endpoints

Spam Defence

• Honeypot: Hidden website field on registration — bots that fill it get a fake 201 response
• Rate limiting: Per-user cooldowns on thread posts (60s), replies (30s), and listings (120s)
• Auto-flagging: Posts with URLs from accounts <24h old or users with <5 posts are auto-flagged for review

Admin Moderation

Reply Notifications

Dispatch Board

The dispatch board provides a Kanban drag-and-drop interface for managing daily appointments. Columns represent statuses (Pending, Dispatched, In Progress, Completed) and drivers can be reassigned by dragging cards between lanes.

Live Driver GPS Tracking

Active drivers broadcast their GPS position in real time. The fleet map shows live driver markers that update continuously, giving dispatchers full visibility into driver locations.

Auto-Swap Scheduling

When a dumpster is marked full, the system automatically schedules a swap appointment — picking up the full container and delivering a replacement. No manual intervention required.

Auto-Pickup Scheduling

When a rental's preferred pickup date is tomorrow, the system automatically marks the dumpster as full and creates a pickup appointment for the pickup date. This runs daily at 7 AM. If a pickup appointment already exists for the rental (e.g. manually created by the dispatcher), a duplicate is not created.

Time Windows

Appointments support time window preferences: morning (before noon), afternoon (noon–5 PM), or any (all day). Time windows are shown on the dispatch board and used for route ordering.

Invoice Management

Stripe Checkout

Invoices include a Pay Now button that creates a Stripe Checkout session. Customers complete payment on the Stripe-hosted page and are redirected back to the portal.

Recurring Contract Billing

Customers with active contracts can be set to recurring billing. Configure a billing day (1–28) and the system auto-generates invoices each cycle.

Customer Portal Invoice Tab

Campaign Management

Targeting Filters

Campaigns can target customers based on filters such as:

• Status: active, inactive, or all customers
• Last rental date: before or after a given date
• Location: customers at a specific location
• Tags: customer tags for segmentation

Unsubscribe Handling

At-Risk Detection

The system monitors customer activity and flags accounts as at-risk when they exceed the configured inactivity threshold (default: 90 days since last rental). At-risk customers appear in a dedicated dashboard section with recommended actions.

Winback Campaigns

Trigger automated winback emails to re-engage inactive customers. Winback emails can include personalized offers and discount codes to incentivize return bookings.

Configuration

GPS Tracking

Drivers broadcast their GPS position continuously while on active trips. The driver app automatically manages tracking start/stop lifecycle tied to trip status.

ETA Notifications

When a driver is en route, the system calculates the estimated time of arrival and sends an SMS notification to the customer with a live ETA. Customers receive updates when the driver departs and when the ETA changes significantly.

GPS Status Indicator

The fleet map and dispatch board display a GPS status indicator for each driver:

• Green: GPS active, position updated within the last 60 seconds
• Yellow: GPS stale, last update 1–5 minutes ago
• Red: GPS offline, no update for over 5 minutes

How It Works

When your fleet is at capacity, incoming quotes can be automatically forwarded to partner operators within your configured service radius. When a partner accepts and completes the job, you earn a referral fee based on the percentage you set. Partners see overflow quotes in their dashboard and can accept or decline with one click.

Settings

Overflow Quotes

Referral Tracking

Job Postings

Applications

Application Flow

Job seekers browse the public /jobs page, filter by location and type, and submit applications with their contact details and optional resume link. The posting company receives an email notification for each new application. Applications can be reviewed and advanced through statuses directly from the dashboard.

Features

• Background GPS tracking — continuous location reporting during active trips, even when the app is minimized
• Native camera — proof-of-delivery and damage report photos with better quality than browser capture
• QR code scanning — scan dumpster QR codes to dispatch, mark full, or return bins
• Push notifications — native push alerts for new stops, schedule changes, and dispatch updates
• Offline support — queue actions when offline, auto-sync when connectivity returns
• Haptic feedback — vibration on successful scans and completed actions

Installation

The Android app is distributed as an APK. Contact your administrator for the install link. The app connects to the same backend as the web version — log in with your existing driver credentials.

How it works

The platform tracks suspicious requests per IP address in real time. Each failed authentication attempt, malformed request, or access to non-existent routes increments a suspicion counter. When the counter exceeds the configured threshold, the IP is automatically banned and all further requests are rejected with 403 Forbidden.

Configuration

Bot honeypot

Common attack paths (e.g. /wp-admin, /.env, /phpmyadmin) are trapped by a honeypot layer. Requests to these paths receive a 404 response after a 3-second tarpit delay, and each hit counts as 10x suspicious — meaning bots trigger the auto-ban threshold much faster than regular users.

Superadmin endpoints

CopyPOST /api/superadmin/banned-ips
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "ip": "203.0.113.42",
  "duration_minutes": 60,
  "reason": "Repeated brute-force attempts"
}

CopyDELETE /api/superadmin/banned-ips/203.0.113.42
Authorization: Bearer eyJ...

Real-time counters

Returns a snapshot of live platform activity:

CopyGET /api/superadmin/live
Authorization: Bearer eyJ...

// 200 OK
{
  "requests_per_minute": 142,
  "active_sockets": 38,
  "unique_ips": 97,
  "status_codes": { "200": 1284, "304": 412, "401": 7, "404": 3 },
  "top_endpoints": [
    { "path": "/api/rentals", "count": 204 },
    { "path": "/api/dumpsters", "count": 187 }
  ],
  "recent_logins": [
    { "user": "jdcadmin", "company": "justins-dumpster-company", "at": "2026-03-10T14:32:00Z" }
  ],
  "activity_feed": [
    { "type": "rental_created", "company": "acme-hauling", "at": "2026-03-10T14:31:45Z" }
  ]
}

Platform analytics

Returns aggregated platform metrics for the specified time range:

CopyGET /api/superadmin/analytics?range=30d
Authorization: Bearer eyJ...

// 200 OK
{
  "daily_rentals": [ { "date": "2026-03-01", "count": 14 }, ... ],
  "daily_quotes": [ { "date": "2026-03-01", "count": 31 }, ... ],
  "daily_signups": [ { "date": "2026-03-01", "count": 2 }, ... ],
  "most_active_companies": [
    { "slug": "acme-hauling", "rentals": 87, "revenue": 12450.00 }
  ],
  "conversion_stats": {
    "quotes_to_rentals": 0.42,
    "trials_to_paid": 0.31
  },
  "forum_posts": 156,
  "listings_count": 42,
  "jobs_count": 18,
  "recent_users": [
    { "username": "newdriver", "company": "acme-hauling", "created_at": "2026-03-09T10:15:00Z" }
  ]
}