Skip to main content
GET
Search CoworkerDeliveries
A delivery records mail, parcels, checks, publicity, or other items received at a location for a customer or contract contact. For ordinary customers, track collection only; for virtual-office customers, the handling preference selects a processing sequence and its completed lifecycle steps.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerDelivery-List role.

Enums

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the location that owns this delivery. Defaults to the current location when creating a delivery..
integer
Filter by iD of the customer this delivery is for. Use either CoworkerId or ContractContactId to identify the recipient..
string
Filter by display value for Coworker.CoworkerType..
string
Filter by display value for Coworker.FullName..
string
Filter by display value for Coworker.Email..
string
Filter by display value for Coworker.BillingName..
string
Filter by display value for Coworker.CompanyName..
string
Filter by display value for Coworker.TeamNames..
integer
Filter by iD of the contract contact receiving this delivery when it is not assigned to a customer..
string
Filter by display value for ContractContact.FullName..
string
Filter by display value for ContractContact.Email..
string
Filter by required short reference that identifies the delivery item..
string
Filter by required physical storage location for the delivery, such as a mailroom shelf..
string
Filter by name of the staff member who received the delivery..
string
Filter by free-text operational notes about the delivery..
string
Filter by current file name of the file data (read-only; upload via the corresponding URL field).
string
Filter by uRL of a new file to upload as the file data.
boolean
Filter by set to true to remove the current file data file.
string
Filter by current file name of the signature (read-only; upload via the corresponding URL field).
string
Filter by uRL of a new file to upload as the signature.
boolean
Filter by set to true to remove the current signature file.
string
Filter by current file name of the scanned file data (read-only; upload via the corresponding URL field).
string
Filter by uRL of a new file to upload as the scanned file data.
boolean
Filter by set to true to remove the current scanned file data file.
string
Filter by current file name of the forwarded file data (read-only; upload via the corresponding URL field).
string
Filter by uRL of a new file to upload as the forwarded file data.
boolean
Filter by set to true to remove the current forwarded file data file.
boolean
Filter by whether all required virtual-office handling steps have been completed; it is calculated from the selected HandlingPreference and is not relevant for ordinary customer deliveries..
boolean
Filter by whether the customer has collected the delivery; set CollectedOn when recording collection..
boolean
Filter by whether the customer must provide a signature when collecting the delivery..
boolean
Filter by whether the customer has signed for the delivery; attach the signature through NewSignatureUrl when available..
boolean
Filter by whether the system sent the delivery-received notification; maintained by delivery notification handlers..
string
Filter by date and time the customer collected the delivery; record it when marking Collected as true..
boolean
Filter by whether charges for delivery handling have been billed; maintained by the delivery processing workflow..
integer
Filter by type of delivery item: Mail, Parcel, Check, Publicity, or Other. It selects the default handling preference for virtual-office customers..
integer
Filter by virtual-office delivery workflow: StoreForCollection, Forward, OpenScanForward, OpenScanRecycle, OpenScanShred, OpenScanStoreForCollection, Recycle, ReturnToSender, Shred, DepositCheck, or Unknown. It is not relevant for customers without a virtual-office contract; for virtual-office customers it defaults from the active contract by delivery type, falling back to StoreForCollection..
boolean
Filter by for a virtual-office DepositCheck workflow, whether the enclosed check has been deposited; record CheckDepositedOn when marking it complete..
boolean
Filter by for a virtual-office forwarding workflow, whether the delivery has been forwarded to the customer; record ForwardedOn when marking it complete..
boolean
Filter by for a virtual-office open-and-scan workflow, whether the delivery contents have been scanned; record ScannedOn when marking it complete..
boolean
Filter by for a virtual-office recycling workflow, whether the delivery has been recycled; record RecycledOn when marking it complete..
boolean
Filter by for a virtual-office shredding workflow, whether the delivery has been shredded; record ShreddedOn when marking it complete..
boolean
Filter by for a virtual-office collection workflow, whether the delivery has been stored for customer collection; record StoredForCollectionOn when marking it complete..
boolean
Filter by for a virtual-office return workflow, whether the delivery has been returned to the sender; record ReturnedToSenderOn when marking it complete..
string
Filter by for a virtual-office DepositCheck workflow, date and time the check was deposited, recorded with CheckDeposited..
string
Filter by for a virtual-office forwarding workflow, date and time the delivery was forwarded, recorded with Forwarded..
string
Filter by for a virtual-office open-and-scan workflow, date and time the delivery contents were scanned, recorded with Scanned..
string
Filter by for a virtual-office recycling workflow, date and time the delivery was recycled, recorded with Recycled..
string
Filter by for a virtual-office shredding workflow, date and time the delivery was shredded, recorded with Shredded..
string
Filter by for a virtual-office collection workflow, date and time the delivery was placed in storage for collection, recorded with StoredForCollection..
string
Filter by for a virtual-office return workflow, date and time the delivery was returned to the sender, recorded with ReturnedToSender..
string
Filter by unique ID of the nominated forwarding address; defaults from the virtual-office contract and is managed by the delivery workflow..
string
Filter by unique ID of the product charge created for depositing a check; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for forwarding; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for scanning; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for recycling; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for shredding; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for storage for collection; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for returning to sender; managed by the delivery workflow..
string
Filter by unique ID of the product charge created for collection; managed by the delivery workflow..

Range Filters

string
Filter by date and time the customer collected the delivery; record it when marking Collected as true. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date and time the customer collected the delivery; record it when marking Collected as true. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office DepositCheck workflow, date and time the check was deposited, recorded with CheckDeposited. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office DepositCheck workflow, date and time the check was deposited, recorded with CheckDeposited. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office forwarding workflow, date and time the delivery was forwarded, recorded with Forwarded. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office forwarding workflow, date and time the delivery was forwarded, recorded with Forwarded. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office open-and-scan workflow, date and time the delivery contents were scanned, recorded with Scanned. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office open-and-scan workflow, date and time the delivery contents were scanned, recorded with Scanned. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office recycling workflow, date and time the delivery was recycled, recorded with Recycled. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office recycling workflow, date and time the delivery was recycled, recorded with Recycled. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office shredding workflow, date and time the delivery was shredded, recorded with Shredded. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office shredding workflow, date and time the delivery was shredded, recorded with Shredded. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office collection workflow, date and time the delivery was placed in storage for collection, recorded with StoredForCollection. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office collection workflow, date and time the delivery was placed in storage for collection, recorded with StoredForCollection. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office return workflow, date and time the delivery was returned to the sender, recorded with ReturnedToSender. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by for a virtual-office return workflow, date and time the delivery was returned to the sender, recorded with ReturnedToSender. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

CoworkerDelivery[]
The list of CoworkerDelivery records matching the query. See the Get one CoworkerDelivery endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each CoworkerDelivery. The following fields are not populated in the Records[] response: Notes, RequiresSignature, Signed.To get all fields, fetch the full record using the Get one CoworkerDelivery endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response