Riferimento APIQuotes
Retrieve a quote
GET
apiKeyheader
AuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
Format
uuidOK
application/json- response
object*stringid*stringlivemode*booleannumber*stringNumber and year, one sequence per year
status*stringdraft → sent (emailed) → accepted or declined; a draft or sent quote past valid_until reads as expired
Value in
"draft""sent""accepted""declined""expired"date*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
datevalid_until*|nullcustomer*lines*array<>notes*string|nullcurrency*stringamount_subtotal*stringDecimal amount as a string
Match
^-?\d+\.\d{2}$amount_tax*stringDecimal amount as a string
Match
^-?\d+\.\d{2}$amount_total*stringDecimal amount as a string
Match
^-?\d+\.\d{2}$invoice_id*|The invoice draft created by POST /quotes/{id}/convert
sent_at*|nullaccepted_at*|nulldeclined_at*|nullconverted_at*|nullcreated_at*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-timeupdated_at*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-timecurl -X GET 'https://www.getbeel.com/api/v1/quotes/string'Esempio di risposta
{ "object": "quote", "id": "qt_5b0e…", "livemode": true, "number": "12/2026", "status": "draft", "date": "2026-10-29", "valid_until": "2026-10-29", "customer": { "name": "string", "email": "string", "partita_iva": "string", "codice_fiscale": "string", "country": "string", "address": "string", "postal_code": "string", "city": "string", "province": "string", "codice_destinatario": "string", "pec": "string" }, "lines": [ { "description": "string", "quantity": 0, "unit_price": 0, "unit": "string", "vat_rate": 0, "natura": "string", "amount": "122.00" } ], "notes": "string", "currency": "string", "amount_subtotal": "122.00", "amount_tax": "122.00", "amount_total": "122.00", "invoice_id": "string", "sent_at": "2019-08-24T14:15:22Z", "accepted_at": "2019-08-24T14:15:22Z", "declined_at": "2019-08-24T14:15:22Z", "converted_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}