List Quotes

Returns paginated quote records for the authenticated merchant environment.

Query parameters

Name	Type	Required	Description
page	number	No	Page number to retrieve.
per_page	number	No	Records per page.
status	string	No	Filter by quote status.
search	string	No	Search by reference or location text.

Example response

<?php

return [
  'success' => true,
  'data' => [
    [
      'quote_id' => 'quote_123',
      'merchant_order_ref' => 'ORD-8842',
      'shipment_id' => 'shp_101',
      'status' => 'pending',
      'requested_at' => '2026-02-17T10:22:00Z',
      'expires_at' => '2026-02-17T11:22:00Z',
      'options' => [
        [
          'quote_option_id' => 'qopt_001',
          'carrier_code' => 'fastship',
          'service_code' => 'next_day',
          'currency' => 'ZAR',
          'amount' => '225.00',
          'tax_amount' => '33.75',
          'total_amount' => '258.75',
          'eta_from' => '2026-02-18T08:00:00Z',
          'eta_to' => '2026-02-18T17:00:00Z',
          'rules' => [
            'max_weight_kg' => 25
          ]
        ]
      ],
      'selected_option' => null
    ]
  ],
  'meta' => [
    'current_page' => 1,
    'last_page' => 3,
    'per_page' => 20,
    'total' => 45
  ]
];

Request examples

curl -X GET \
  "https://api.spaces.za.com/api/v1/quotes" \
  -H "Authorization: Bearer <token>" \\