Search Order Notes

Notes can also be searched with the Order Note API. This is useful to find a specific note for an order when the unique Note ID is unknown, because the Order ID can be provided as the search parameter. The API will then return all notes that apply to that order.

Supported FormatsJSON

The .json address above can be used to access the schema within Postman. An example use of the Order Note API follows here — or go directly to the schema or the sample Postman Collection.

The request itself is built within the URL by adding a “/?” to the call followed by specific parameters joined by the “&” symbol. For instance, searching for public notes from a particular order would use the following format:

  •[Order ID]&public=true


The example case will search for all notes that belong to an order with the ID 111111.

Required Parameters

Searching for an order note requires one of the following:

orderIDstringA single or list of unique identifiers for orders. These must all be positive integers.
externalOrderIDstringA client-generated unique identifier for the order. The minimum length is 1 and the maximum length is 100.

Optional Parameters

Notes can also be found based on one or more of these additional parameters:

noteStartTimestring (date-time)Search for order notes created on or after this date.
noteEndTimestring (date-time)Search for order notes created on or before this date.
publicbooleanWhether the note is publicly viewable.
shipmentIDstringA single or list of unique identifiers for shipments. These must all be positive integers.
userIDintegerA unique identifier for the user. The minimum value is "1".

The Full Request

This is the entire request that will search for Order Notes belonging to the Order 111111.

The Full Response

This is what the collection of note results would look like.

    "collection": [
            "noteID": 2299922,
            "orderID": 111111,
            "note": "this is a note",
            "noteTime": "2015-07-21T19:32:50+00:00",
            "public": true,
            "userID": 55555,
            "userName": "Customer Service Customer Service"
            "noteID": 9922299,
            "orderID": 111111,
            "note": "Here is another note.",
            "noteTime": "2017-04-06T15:36:18+00:00",
            "public": true,
            "userID": 66666,
            "userName": "ZZZ Company Information System"


Megan MayfieldOMS Dev: Search Order Notes