Quotes API
Get Quote
Retrieve a single quote by its public key.
Endpoint
GET /api/quotes/<key>Authentication
Authorization: Bearer <your-api-token>Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | The public-facing quote key (found in customer page URLs) |
Example Request
curl -X GET "https://app.salesbyte.se/api/quotes/hLcblYXo3BJh8Z" \
-H "Authorization: Bearer <your-api-token>"Response
Returns the full quote resource:
{
"id": 950,
"key": "hLcblYXo3BJh8Z",
"quote_profile_name": "Standard Quote",
"customer_name": "Acme Corp",
"customer_first_name": "John",
"customer_last_name": "Doe",
"customer_company": "Acme Corp",
"customer_phone": "+46701234567",
"customer_email": "[email protected]",
"address_firstline": "123 Main Street",
"address_secondline": null,
"address_postcode": "12345",
"address_city": "Stockholm",
"custom_fields": {
"Industry": "Technology",
"Company Size": "50-100"
},
"quote_value": 15000,
"created_at": "2025-01-15T10:30:00.000000Z",
"updated_at": "2025-01-16T14:22:00.000000Z",
"salesperson": {
"name": "Jane Smith",
"email": "[email protected]"
},
"is_signed": true,
"is_fully_signed": true,
"requires_more_signatures": false,
"is_project_approval_pending": false,
"is_project_approval_signed": false,
"signed_offer": {
"main_document_name": "Quote #950",
"main_document_url": "https://app.salesbyte.se/documents/...",
"extra_documents": []
},
"signed_products": {
"original_price_including_vat": 15000,
"price_including_vat": 15000,
"discount_including_vat": 0,
"currency": "SEK",
"products": [
{
"sku": "PROD-001",
"amount": 1,
"url": null,
"name": "Enterprise License",
"original_price_including_vat": 15000,
"price_including_vat": 15000,
"original_sum_including_vat": 15000,
"sum_including_vat": 15000,
"currency": "SEK",
"price_unit": "pcs"
}
]
},
"additional_documents_signed": [],
"additional_documents_requiring_signature": [],
"statuses": ["signed", "delivered"],
"links": {
"edit": "https://app.salesbyte.se/offerter/950/redigera",
"customer_view": "https://app.salesbyte.se/view/hLcblYXo3BJh8Z",
"customer_verificate": "https://app.salesbyte.se/signed/hLcblYXo3BJh8Z",
"customer_project_approval": "https://app.salesbyte.se/view/hLcblYXo3BJh8Z?project_approval=1"
}
}Response Fields
The response structure matches the Quote Checkout Webhook payload. See that documentation for complete field descriptions.
Basic Information
| Field | Type | Description |
|---|---|---|
id | integer | Internal quote identifier |
key | string | Public-facing key (used in customer page URLs) |
quote_profile_name | string | Name of the quote profile used |
quote_value | numeric | null | Total value of the quote |
created_at | string | Timestamp when quote was created (ISO 8601) |
updated_at | string | Timestamp when quote was last updated (ISO 8601) |
Customer Information
| Field | Type | Description |
|---|---|---|
customer_name | string | Full name of the customer |
customer_first_name | string | null | First name |
customer_last_name | string | null | Last name |
customer_company | string | null | Company name |
customer_phone | string | null | Phone number |
customer_email | string | null | Email address |
Address Information
| Field | Type | Description |
|---|---|---|
address_firstline | string | null | First line of address |
address_secondline | string | null | Second line of address |
address_postcode | string | null | Postcode |
address_city | string | null | City |
Signature Status
| Field | Type | Description |
|---|---|---|
is_signed | boolean | Quote has at least one signature |
is_fully_signed | boolean | All required signatures collected |
requires_more_signatures | boolean | More signatures still needed |
is_project_approval_pending | boolean | Project approval is pending |
is_project_approval_signed | boolean | Project approval has been signed |
Links
| Field | Type | Description |
|---|---|---|
links.edit | string (URL) | Back-office edit page |
links.customer_view | string (URL) | Customer view page |
links.customer_verificate | string (URL) | Customer verification page |
links.customer_project_approval | string (URL) | Project approval page |
Status Codes
| Status Code | Description |
|---|---|
200 OK | Request successful |
401 Unauthorized | Missing or invalid Bearer token |
404 Not Found | Quote with specified key not found |
500 Internal Server Error | Server error |