Search CoworkerDeliveries

GET

api

spaces

coworkerdeliveries

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/coworkerdeliveries \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/coworkerdeliveries"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/coworkerdeliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

A CoworkerDelivery tracks a delivery (mail, parcel, check, or other item) received on behalf of a customer at a location, along with its current processing status and the customer’s handling preference. Each delivery records who it is for (CoworkerId or ContractContactId), what it is (DeliveryType), and how the customer wants it handled (HandlingPreference). Staff can then mark the delivery through its lifecycle — processed, collected, forwarded, scanned, recycled, shredded, or returned to sender — with corresponding timestamps. Handling preferences control what happens to the delivery:

HandlingPreference	Meaning
StoreForCollection	Hold for the customer to pick up
Forward	Forward to the customer’s address
OpenScanForward	Open, scan contents, then forward the original
OpenScanRecycle	Open, scan contents, then recycle the original
OpenScanShred	Open, scan contents, then shred the original
OpenScanStoreForCollection	Open, scan contents, then hold for collection
Recycle	Recycle the delivery
ReturnToSender	Return the delivery to the sender
Shred	Shred the delivery
DepositCheck	Deposit the enclosed check

Deliveries can also have attached files — for example, a scanned copy of the contents (NewScannedFileDataUrl), a forwarding receipt (NewForwardedFileDataUrl), or a collection signature (NewSignatureUrl).

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

eDeliveryType — DeliveryType values

Value	Name
0	None
1	Mail
2	Parcel
3	Check
4	Publicity
5	Other

eDeliveryHandlingPreference

Value	Name
0	None
1	StoreForCollection
2	Forward
3	OpenScanForward
4	OpenScanRecycle
5	OpenScanShred
6	OpenScanStoreForCollection
7	Recycle
8	ReturnToSender
9	Shred
10	DepositCheck
11	Unknown

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 business linked to this record.

integer

Filter by iD of the coworker linked to this record.

string

Filter by the coworker coworker type value for this coworker delivery.

string

Filter by full name of the customer the delivery is for.

string

Filter by email address of the customer the delivery is for.

string

Filter by billing name of the customer the delivery is for.

string

Filter by company name of the customer the delivery is for.

string

Filter by team names the customer belongs to.

integer

Filter by iD of the contract contact linked to this record.

string

Filter by full name of the contract contact the delivery is for.

string

Filter by email address of the contract contact the delivery is for.

string

Filter by short label or description identifying the delivery item.

string

Filter by physical location where the delivery is being stored (e.g. mailroom shelf).

string

Filter by name of the staff member who received the delivery.

string

Filter by free-text 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 the delivery has been processed according to the handling preference.

boolean

Filter by whether the customer has collected the delivery.

boolean

Filter by whether the customer must sign upon collection.

boolean

Filter by whether the customer has signed for the delivery.

boolean

Filter by whether notified is enabled.

string

Filter by date and time the customer collected the delivery.

boolean

Filter by whether billed is enabled.

integer

Filter by type of delivery item (Mail, Parcel, Check, Publicity, or Other).

integer

Filter by how the customer wants this delivery handled (e.g. StoreForCollection, Forward, Shred).

boolean

Filter by whether the enclosed check has been deposited.

boolean

Filter by whether the delivery has been forwarded to the customer.

boolean

Filter by whether the delivery contents have been scanned.

boolean

Filter by whether the delivery has been recycled.

boolean

Filter by whether the delivery has been shredded.

boolean

Filter by whether the delivery is being held for customer collection.

boolean

Filter by whether the delivery has been returned to sender.

string

Filter by date and time the check was deposited.

string

Filter by date and time the delivery was forwarded.

string

Filter by date and time the delivery contents were scanned.

string

Filter by date and time the delivery was recycled.

string

Filter by date and time the delivery was shredded.

string

Filter by date and time the delivery was placed in storage for collection.

string

Filter by date and time the delivery was returned to sender.

string

Filter by iD of the forwarding address unique associated with this record.

string

Filter by iD of the check deposited product unique associated with this record.

string

Filter by iD of the forwarded product unique associated with this record.

string

Filter by iD of the scanned product unique associated with this record.

string

Filter by iD of the recycled product unique associated with this record.

string

Filter by iD of the shredded product unique associated with this record.

string

Filter by iD of the stored for collection product unique associated with this record.

string

Filter by iD of the returned to sender product unique associated with this record.

string

Filter by iD of the collected product unique associated with this record.

Range Filters

string

Filter by date and time the customer collected the delivery greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the customer collected the delivery less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the check was deposited greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the check was deposited less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was forwarded greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was forwarded less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery contents were scanned greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery contents were scanned less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was recycled greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was recycled less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was shredded greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was shredded less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was placed in storage for collection greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was placed in storage for collection less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was returned to sender greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date and time the delivery was returned to sender 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

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/coworkerdeliveries?page=1&size=15&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/coworkerdeliveries?' + new URLSearchParams({
    page: 1,
    size: 15,
    orderBy: 'Name',
    dir: 1 // Ascending
  }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/spaces/coworkerdeliveries',
    params={
        'page': 1,
        'size': 15,
        'orderBy': 'Name',
        'dir': 0 // Ascending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

Filtering by Name

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/coworkerdeliveries?CoworkerDelivery_Name=example-value&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/coworkerdeliveries?' + new URLSearchParams({
    CoworkerDelivery_Name: 'example-value',
    orderBy: 'Name',
    dir: 1
  }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/spaces/coworkerdeliveries',
    params={
        'CoworkerDelivery_Name': 'example-value',
        'orderBy': 'Name',
        'dir': 0 // Ascending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

Range filters

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/coworkerdeliveries?from_CoworkerDelivery_UpdatedOn=2025-01-01T00:00&to_CoworkerDelivery_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/coworkerdeliveries?' + new URLSearchParams({
    from_CoworkerDelivery_UpdatedOn: '2025-01-01T00:00',
    to_CoworkerDelivery_UpdatedOn: '2025-12-31T23:59',
    orderBy: 'UpdatedOn',
    dir: 1 // Descending
   }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/spaces/coworkerdeliveries',
    params={
        'from_CoworkerDelivery_UpdatedOn': '2025-01-01T00:00',
        'to_CoworkerDelivery_UpdatedOn': '2025-12-31T23:59',
        'orderBy': 'UpdatedOn',
        'dir': 1 // Descending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

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

{
  "Records": [
    {
      "BusinessId": 0,
      "CoworkerId": null,
      "CoworkerCoworkerType": null,
      "CoworkerFullName": null,
      "CoworkerEmail": null,
      "CoworkerBillingName": null,
      "CoworkerCompanyName": null,
      "CoworkerTeamNames": null,
      "ContractContactId": null,
      "ContractContactFullName": null,
      "ContractContactEmail": null,
      "Name": "",
      "Location": "",
      "ReceivedBy": null,
      "FileDataFileName": null,
      "NewFileDataUrl": null,
      "ClearFileDataFile": null,
      "SignatureFileName": null,
      "NewSignatureUrl": null,
      "ClearSignatureFile": null,
      "ScannedFileDataFileName": null,
      "NewScannedFileDataUrl": null,
      "ClearScannedFileDataFile": null,
      "ForwardedFileDataFileName": null,
      "NewForwardedFileDataUrl": null,
      "ClearForwardedFileDataFile": null,
      "Processed": false,
      "Collected": false,
      "Notified": false,
      "CollectedOn": null,
      "Billed": false,
      "DeliveryType": 0,
      "HandlingPreference": 0,
      "CheckDeposited": false,
      "Forwarded": false,
      "Scanned": false,
      "Recycled": false,
      "Shredded": false,
      "StoredForCollection": false,
      "ReturnedToSender": false,
      "CheckDepositedOn": null,
      "ForwardedOn": null,
      "ScannedOn": null,
      "RecycledOn": null,
      "ShreddedOn": null,
      "StoredForCollectionOn": null,
      "ReturnedToSenderOn": null,
      "ForwardingAddressUniqueId": null,
      "CheckDepositedProductUniqueId": null,
      "ForwardedProductUniqueId": null,
      "ScannedProductUniqueId": null,
      "RecycledProductUniqueId": null,
      "ShreddedProductUniqueId": null,
      "StoredForCollectionProductUniqueId": null,
      "ReturnedToSenderProductUniqueId": null,
      "CollectedProductUniqueId": null,
      "Id": 87654321,
      "UpdatedOn": "2025-01-15T10:30:00Z",
      "CreatedOn": "2025-01-10T08:00:00Z",
      "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "UpdatedBy": "admin@example.com",
      "IsNew": false,
      "SystemId": null,
      "ToStringText": "CoworkerDelivery Example",
      "LocalizationDetails": null,
      "CustomFields": null
    }
  ],
  "CurrentPageSize": 15,
  "CurrentPage": 1,
  "CurrentOrderField": "Name",
  "CurrentSortDirection": 1,
  "FirstItem": 1,
  "HasNextPage": false,
  "HasPreviousPage": false,
  "LastItem": 1,
  "PageNumber": 1,
  "PageSize": 15,
  "TotalItems": 1,
  "TotalPages": 1
}

Get one CoworkerDeliveryRetrieve a single CoworkerDelivery record by its Id.

Search CoworkerDeliveries

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/coworkerdeliveries \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/coworkerdeliveries"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/coworkerdeliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Query Parameters

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

​Authentication

​Enums

​Query Parameters

​Pagination & Sorting

​Filters

​Range Filters

​Code Examples

​Simple listing

​Filtering by Name

​Range filters

​Response

​200

Authentication

Enums

Query Parameters

Pagination & Sorting

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200