Skip to main content
POST
/
api
/
v1
/
quarterly-payments
Create Quarterly Payment
curl --request POST \
  --url https://api.example.com/api/v1/quarterly-payments \
  --header 'Content-Type: application/json' \
  --data '
{
  "year": 123,
  "quarter": 123,
  "paid_cents": 123,
  "paid_date": "<string>",
  "confirmation_number": "<string>",
  "notes": "<string>"
}
'

Request Body

year
integer
required
Tax year (YYYY).
quarter
integer
required
Quarter number: 1, 2, 3, or 4.
paid_cents
integer
required
Amount paid in cents. Must be ≥ 0.
paid_date
string
required
Date of payment (YYYY-MM-DD).
confirmation_number
string
Payment confirmation number (max 100 chars).
notes
string
Additional notes (max 500 chars).

Response

Returns the created payment with status 201.

Errors

StatusCause
400Invalid quarter, paid_cents < 0, missing required fields
409Payment already exists for this user/year/quarter combination