CLAIM-881-HOURS
16 hours of plumbing
Mon, Nov 16 to Tue, Nov 17 · 30306
16 hours of plumbing reserved with 1 pro from Nov 16 to Nov 17. Attach a job by Nov 13, 8:00 AM EST or the hours go back.
Capacity · reserve crew hours ahead
Committed
A pro commits hours for next month in the Pro app. Without a commitment, a free calendar is not for sale.
Free that day
Days with a job, a visit, a day off or another hold come off. A reserved half day is taken for everyone else too.
Qualified
The trade and level, every step kind you name and its license, the credentials you ask for, verified and current, and the tier.
Committed and free in Atlanta, Nov 16 – Nov 29
Simulated supply| Trade | Week of Nov 16 | Week of Nov 23 |
|---|---|---|
Plumbing 3 pros committed | 120h 3 pros | 120h 3 pros |
Each week is read on its own. A pro's hours for the month can be reserved in any week, so reserving them in one week takes them from the others.
See what's open
Hours by trade and week at a ZIP, counted from what qualified pros committed for the month on days their calendar is free. Filter by level, credentials, step kinds and tier. Where nothing is committed the answer is zero, with a note that says so.
GET/settlement/capacityReserve hours
A trade, a ZIP, a window and the hours, in half days of 4. All of them or none. Each pro holding hours is asked to confirm in the Pro app, and the reservation gets a lapse time.
POST/settlement/capacity/reservationsAttach a job before it lapses
Give it one of your settlement jobs. The reserved pros become your executors, paid on verified proof like any other step.
POST/settlement/capacity/reservations/{id}/convertOr let the hours go
Before the work starts. They go back on the pros' open calendars. A release close to the work is recorded as late.
POST/settlement/capacity/reservations/{id}/releaseavailable → held
You reserve committed hours
held → converted
You attach a job in time
held → released
You release it, or it lapses
held → failed
Nobody can refill the hours
converted → released
You release it before it starts
converted → failed
Nobody can refill the hours
shortfall.hours says how many nobody could take. Any credit for them is shown there; none is set today.| X-4S-Simulate | What happens |
|---|---|
happy | The default. Simulated pros hold the hours and confirm. |
pro_withdraws | One simulated pro pulls out after confirming. A simulated standby pro takes the hours, and you get settlement.capacity_refilled. |
no_refill | One simulated pro pulls out and the simulated bench is empty. You get settlement.capacity_short. |
no_supply | The area has no committed hours. Availability is zero and a reservation is refused. |
A reservation as the sandbox answered it, simulated pros
CLAIM-881-HOURS
16 hours of plumbing
Mon, Nov 16 to Tue, Nov 17 · 30306
16 hours of plumbing reserved with 1 pro from Nov 16 to Nov 17. Attach a job by Nov 13, 8:00 AM EST or the hours go back.
settlement.capacity_reserved
Hours were reserved for you. They are held until the lapse time.
settlement.capacity_converted
A reservation was attached to a job. The hours stay on the pros' calendars for it.
settlement.capacity_released
A reservation was released by you, or it lapsed because no job was attached in time. The reason says which.
settlement.capacity_refilled
A pro pulled out, didn't confirm or didn't come, and another qualified pro took every hour they held. The message says what happened.
settlement.capacity_short
A pro pulled out, didn't confirm or didn't come, and some or all of their hours could not be refilled. The message says how many are still held.
Payloads and the signature check are on Webhooks.