Build with ProBiddr

Connect homeowners with contractors through our powerful API. Post jobs, submit bids, manage projects, and process payments — all in one platform.

Browse API Reference Quick Start Guide

Why ProBiddr API?

🔐

Secure Authentication

JWT-based authentication with refresh tokens. Separate endpoints for homeowners and contractors.

🏗️

Job Management

Create, browse, and manage job postings. Support for multiple trades, priorities, and custom requirements.

💰

Bidding System

Submit bids with token costs. Priority and urgent bid options for contractors who want visibility.

💬

Real-time Messaging

Built-in messaging between homeowners and contractors. Thread-based conversations per job.

🪙

Virtual Currency

Token-based economy. Purchase token packages, earn through referrals, and manage balances.

⭐

Reviews & Ratings

Build reputation through customer reviews. Star ratings and written feedback for completed jobs.

Get Started in Minutes

The ProBiddr API uses RESTful endpoints with JSON payloads. All requests require authentication via JWT access tokens.

1 Sign up for a ProBiddr account (homeowner or contractor)
2 Authenticate with your credentials to receive tokens
3 Include the access token in all API requests
4 Start posting jobs or submitting bids

View full API documentation →

# 1. Authenticate
curl -X POST https://api.probiddr.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "contractor@example.com",
    "password": "your_password"
  }'

# 2. Use the access token
curl https://api.probiddr.com/v1/jobs \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 3. Create a job posting
curl -X POST https://api.probiddr.com/v1/jobs \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Kitchen Remodel",
    "description": "Full kitchen renovation...",
    "trade": "General Contractor",
    "priority": "standard"
  }'
        