Create My Service Statement
POST /marketplace/me/service-statements
Open a draft statement for one of your engagements.
THE PERIOD IS SERVER-DERIVED and any you send is ignored: an active
engagement bills the previous complete calendar month, a terminated one
bills its earliest unbilled month. The retainer is PRORATED to the days the
engagement was actually live, and the meeting lines are generated from the
engagement’s own rate, so amount is the sum of the lines and never a typed
figure. Add commission / bonus / expense / discount lines, then submit.
409 when a statement already exists for that period. 403 on an agency-managed engagement - the agency authors those.
Authorizations
Parameters
Header Parameters
Request Body required
Open a draft statement for one engagement.
period_start / period_end / amount are accepted for parity with the
app model and IGNORED by it. The billing period is derived server-side (the
previous complete calendar month, or a terminated engagement’s earliest
unbilled month) so nobody can pick a window that mis-prorates the retainer,
and the amount is the sum of the statement’s line items. They are documented
as ignored rather than dropped from the contract, because dropping a field
the app model declares is what makes a proxy 500 on a required one.
object
The hiring/engagement to bill. Must be your own.
Responses
201
Successful Response
object
One record, or one action result.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error