Create quote
POST
apiKeyheader
AuthorizationBearer <token>An API key (blk_…) from Settings → API keys.
application/json- body
clientId*stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidtitle?|Length
length <= 200currency?stringMatch
^[A-Z]{3}$Length
3 <= length <= 3issueDate?stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datevalidUntil?|Match
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datenotes?|Length
length <= 5000terms?|Length
length <= 5000lines?array<>Items
items <= 200Default
[]application/json- response
id*stringnumber*string|nullstatus*stringValue in
"draft""sent""accepted""declined"isExpired*booleantitle*string|nullclientId*stringclientName*stringcurrency*stringissueDate*stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datevalidUntil*|Match
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Format
datesubtotal*integerRange
-9007199254740991 <= value <= 9007199254740991taxTotal*integerRange
-9007199254740991 <= value <= 9007199254740991total*integerRange
-9007199254740991 <= value <= 9007199254740991createdAt*stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Format
date-timeupdatedAt*stringMatch
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Format
date-timenotes*string|nullterms*string|nulllines*array<>sentAt*|Match
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Format
date-timeacceptedAt*|Match
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Format
date-timedeclinedAt*|Match
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Format
date-timerespondedByName*string|nullrespondedVia*|Value in
"manual""portal"nulldeclineReason*string|nullclientSnapshot*|nullissuerSnapshot*|nullinvoiceId*string|nullinvoiceNumber*string|nullcurl -X POST 'https://your-billleaf-api/v1/quotes' \ -H 'Content-Type: application/json' \ -d '{ "clientId": "5e505642-9024-474d-9434-e5a44f505cc5"}'Example Response201
{ "id": "string", "number": "string", "status": "draft", "isExpired": true, "title": "string", "clientId": "string", "clientName": "string", "currency": "string", "issueDate": "2019-08-24", "validUntil": "2019-08-24", "subtotal": -9007199254740991, "taxTotal": -9007199254740991, "total": -9007199254740991, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "notes": "string", "terms": "string", "lines": [ { "id": "string", "position": -9007199254740991, "description": "string", "quantity": 0, "unitPrice": -9007199254740991, "taxRateBps": -9007199254740991, "amount": -9007199254740991, "taxAmount": -9007199254740991 } ], "sentAt": "2019-08-24T14:15:22Z", "acceptedAt": "2019-08-24T14:15:22Z", "declinedAt": "2019-08-24T14:15:22Z", "respondedByName": "string", "respondedVia": "manual", "declineReason": "string", "clientSnapshot": { "name": "string", "legalName": "string", "email": "string", "phone": "string", "taxId": "string", "addressLines": [ "string" ] }, "issuerSnapshot": { "name": "string", "legalName": "string", "email": "string", "phone": "string", "taxId": "string", "addressLines": [ "string" ] }, "invoiceId": "string", "invoiceNumber": "string"}