Stops
Stop Search
See the Stops Search docs for more information on formatting the filter string. The following fields are filterable:
- planId - The ID of the plan stop is linked to in PlanId format (e.g. plans/{planId})
- routeId - The ID of the route stop is linked to in RouteId format (e.g. routes/{routeId})
- type - The type of the stop (e.g. start, stop, end)
- activity - The activity performed at the stop (delivery or pickup)
- notes - Notes associated with the stop
- orderInfo.sellerOrderId - The order ID from the seller
- orderInfo.invoiceNumber - The invoice number of the order
- orderInfo.sellerWebsite - The website URL of the seller
- address.address - The full address of the stop
- address.addressLineOne - The first line of the stop address
- address.addressLineTwo - The second line of the stop address
- address.latitude - The latitude of the stop address in decimal degrees
- address.longitude - The longitude of the stop address in decimal degrees
- address.placeId - The Google Places identifier for the address
- address.countryCode - The ISO country code for the address
- createdAt - The timestamp when the stop was created (ISO 8601)
- arrivalAt - The timestamp of the (estimated) arrival at the stop (ISO 8601)
- packageCount - The number of packages to be delivered or picked up
- estimatedTravelDuration - The estimated travel time to this stop from the previous one, in seconds
- estimatedTravelDistance - The estimated travel distance to this stop from the previous one, in meters
- timing.estimatedAttemptDuration - The estimated time spent at the stop to perform the activity, in seconds
- recipient.name - The name of the recipient at the stop
- recipient.email - The email address of the recipient
- recipient.phone - The phone number of the recipient
- recipient.externalId - An external identifier for the recipient
- deliveryInfo.state - The current state of the delivery. See DeliveryState for all supported values.
- deliveryInfo.attempted - Whether a delivery attempt has been made
- deliveryInfo.succeeded - Whether the delivery was successful
- deliveryInfo.recipientProvidedNotes - Notes provided by the recipient for the driver
- deliveryInfo.driverProvidedInternalNotes - Internal notes provided by the driver
- deliveryInfo.driverProvidedRecipientNotes - Notes for the recipient provided by the driver
- deliveryInfo.signeeName - The name of the person who signed for the delivery
- deliveryInfo.attemptedAt - The timestamp when the delivery was attempted (ISO 8601)
- orderInfo.products - The list of products included in the order
- orderInfo.sellerName - The name of the seller
- paymentOnDelivery.amount - The amount to be collected on delivery, in original units
- barcodes - The list of barcodes associated with the stop
- packageLabel - The label applied to the package(s)
- customProperties.* - A custom property of the stop. Replace * with the custom property ID.
The following fields are sortable:
- address.latitude
- address.longitude
- createdAt
- arrivalAt
- packageCount
- estimatedTravelDuration
- estimatedTravelDistance
- timing.estimatedAttemptDuration
- deliveryInfo.attemptedAt
- paymentOnDelivery.amount
get/stops:search
Request
- Base URLhttps://api.spoke.com/public/v1
- AuthHTTP basic
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
keywordstring
Keywords to include in the search. These will be applied to all applicable text fields using a fuzzy matching.
filterstring
The filter to apply. This is used to include/exclude stops form the search.
pageTokenstring
The page token.
maxPageSizeinteger
The max page size.
sortFieldstring
The sort field.
sortOrder'asc' | 'desc'
The sort direction.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.