List quotes
Your organization's quote history: every quote exported to a customer, newest first, with archived quotes last. Each one carries its status, lanes, and buy, sell and margin per container.
Filter by status, customer_id, who quoted it (exported_by_id), when it was issued (date_from, date_to) or search. Pages with page and size; total counts every match. kind=sheet lists rate sheets exported for no customer instead.
API key scope required: quotes:read.
Query Parameters
- Type: integerpagemin:1
The page, from 1.
- Type: integersizemin:1max:200
Quotes per page, at most 200.
- Type: enumnullablestatus
Only quotes with this status. Omit for all, archived included. Ignored with kind=sheet.
valuespendingacceptedexpiredarchivedrequote_requested - Type: integercustomer
_id greater than:0nullableOnly quotes to this customer.
- Type: integerexported
_by _id greater than:0nullableOnly quotes exported by this user. Omit for everyone.
- Type: stringFormat: date-timenullabledate
_from Only quotes issued at or after this time: a date (2026-11-01) or an ISO 8601 date-time. UTC unless it names a time zone.
- Type: stringFormat: date-timenullabledate
_to Only quotes issued at or before this time. A bare date means its first moment, so use the next day to include a whole day.
- Type: stringnullablesearch
Matches the quote number (Q-000126, 000126 or 126 all find the same quote), the customer's name, or any lane's origin, destination, carrier or commodity. Not case-sensitive.
- Type: enumkind
quote (default) lists exports made for a customer; sheet lists generic exports, which have no customer and therefore no status.
What was exported.
quote: rates sent to one of your customers, which they can accept.sheet: a rate sheet exported for no customer; it has no status. - Type: integerorganization
_id greater than:0nullableHighQube staff only: whose quotes to read. Anyone else can leave it out (their own organization is used) or pass their own; another organization's id is refused with 403.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl 'https://api-dev.highqube.ai/quotes?page=1&size=25&status=pending&customer_id=40&exported_by_id=33&date_from=2026-11-01&date_to=2026-12-01&search=Q-000005&kind=quote&organization_id=15' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
GET /quotes?size=2
{
"success": true,
"message": "Quotes fetched successfully",
"data": {
"items": [
{
"id": 14,
"reference": "Q-000003",
"kind": "quote",
"status": "pending",
"issued_at": "2026-11-10T18:23:16.303825Z",
"valid_until": "2026-12-10T18:23:16.460483Z",
"accepted_at": null,
"accepted_by_name": null,
"requote_requested_at": null,
"archived_at": null,
"customer_id": 6,
"customer_name": "Windy City Electronics",
"quoted_by_id": 9,
"quoted_by_name": "Taylor Morgan",
"place_of_receipt": "Los Angeles, CA (USLAX)",
"place_of_delivery": "Hong Kong, HK (HKHKG)",
"lanes": [
{
"label": "Los Angeles, CA (USLAX) → Hong Kong, HK (HKHKG)",
"origin": "Los Angeles, CA (USLAX)",
"destination": "Hong Kong, HK (HKHKG)",
"rate_count": 2,
"sell": {
"low": 670,
"high": 730
},
"sizes": [
{
"equipment_size": "40'HC",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 2,
"buy": {
"low": 546,
"high": 606
},
"sell": {
"low": 670,
"high": 730
},
"margin": {
"low": 124,
"high": 124
}
}
]
}
],
"service": null,
"commodity": "FAK",
"ship_type": "Ocean · 40'HC · Dry",
"buy": {
"low": 546,
"high": 606
},
"sell": {
"low": 670,
"high": 730
},
"margin": {
"low": 124,
"high": 124
},
"rate_count": 2,
"equipment_sizes": [
"40'HC"
],
"size_bands": [
{
"equipment_size": "40'HC",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 2,
"buy": {
"low": 546,
"high": 606
},
"sell": {
"low": 670,
"high": 730
},
"margin": {
"low": 124,
"high": 124
}
}
],
"currency": "USD",
"accept_url": "https://app.highqube.ai/test-client/q/760eeb1a-4c2b-5764-a65e-5621b1d0662e",
"requoted_from_id": null
},
{
"id": 13,
"reference": "Q-000002",
"kind": "quote",
"status": "pending",
"issued_at": "2026-11-10T18:23:15.072607Z",
"valid_until": "2026-12-10T18:23:15.355689Z",
"accepted_at": null,
"accepted_by_name": null,
"requote_requested_at": null,
"archived_at": null,
"customer_id": 4,
"customer_name": "Midwest Machine Works",
"quoted_by_id": 9,
"quoted_by_name": "Taylor Morgan",
"place_of_receipt": "Chicago, IL (USCHI)",
"place_of_delivery": "Ningbo, CN (CNNBO)",
"lanes": [
{
"label": "Chicago, IL (USCHI) → Ningbo, CN (CNNBO)",
"origin": "Chicago, IL (USCHI)",
"destination": "Ningbo, CN (CNNBO)",
"rate_count": 8,
"sell": {
"low": 450,
"high": 780
},
"sizes": [
{
"equipment_size": "20'",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 4,
"buy": {
"low": 414,
"high": 516
},
"sell": {
"low": 450,
"high": 560
},
"margin": {
"low": 36,
"high": 48
}
},
{
"equipment_size": "40'HC",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 4,
"buy": {
"low": 598,
"high": 722
},
"sell": {
"low": 650,
"high": 780
},
"margin": {
"low": 52,
"high": 65
}
}
]
}
],
"service": null,
"commodity": "FAK",
"ship_type": "Ocean · Multiple · Dry",
"buy": {
"low": 414,
"high": 722
},
"sell": {
"low": 450,
"high": 780
},
"margin": {
"low": 36,
"high": 65
},
"rate_count": 8,
"equipment_sizes": [
"20'",
"40'HC"
],
"size_bands": [
{
"equipment_size": "20'",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 4,
"buy": {
"low": 414,
"high": 516
},
"sell": {
"low": 450,
"high": 560
},
"margin": {
"low": 36,
"high": 48
}
},
{
"equipment_size": "40'HC",
"container_type": "Dry",
"commodities": [
"FAK"
],
"rate_count": 4,
"buy": {
"low": 598,
"high": 722
},
"sell": {
"low": 650,
"high": 780
},
"margin": {
"low": 52,
"high": 65
}
}
],
"currency": "USD",
"accept_url": "https://app.highqube.ai/test-client/q/d32b4822-6c79-5247-80cf-6a2dbf410f21",
"requoted_from_id": null
}
],
"total": 3,
"page": 1,
"size": 2
},
"errors": null,
"meta": null
}
