billing

Record a concession given to a client

post/billing/concessions

Request

Base URL
https://api.verdun.ai (the document declares no server; this is the origin it was published from)
URL
https://api.verdun.ai/billing/concessions
Auth
HTTP bearer

Request body

parent_idstring uuid required

The client the concession was given to.

titlestring required

One line saying what was given.

detailsstring nullable

Anything else worth knowing. Blank or null clears it.

starts_onstring date nullable

When it starts, if dated.

ends_onstring date nullable

When it ends, if it does. On or after starts_on.

Example request

{
  "title": "First month free",
  "details": "Agreed on the 10/14 call in exchange for a 2-year term.",
  "starts_on": "2026-11-01",
  "ends_on": "2027-10-31"
}

Response

Successful Response

idstring uuid required

Concession id.

parent_idstring uuid required

The client it was given to.

parent_namestring nullable

That client's name now.

titlestring required

What was given.

detailsstring nullable

Free-text notes; null if none.

starts_onstring date nullable

Start date, if dated.

ends_onstring date nullable

End date, if it ends.

created_atstring date-time nullable

When it was added.

created_by_namestring nullable

Who added it, as named then.

updated_atstring date-time nullable

When it was last edited; null if never.

updated_by_namestring nullable

Who saved it last, as named then.

Example response

{
  "parent_name": "Northgate Security",
  "title": "First month free",
  "starts_on": "2026-11-01",
  "ends_on": "2027-10-31",
  "created_by_name": "Ada Owner",
  "updated_by_name": "Ada Owner"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.