List of Objects

The 'get List of Objects' API is used to return a list of objects using a TeamTracks list view. This is used when you need all or part of objects from a list view. This is a GET request and returns the data in JSON.

Get List of Objects [EP-1]

The following GET endpoint returns a list of objects based on a specific list view:

https://api.team-tracks.com/object/{viewId}

Making a GET request to the following URL will return a list of all RMAs in the list view, specified by the viewID.

The call should respond with a JSON array of all the RMA objects in the listview. The below blck shows one of the objects returned.

[
    {
        "id": "7c2475a9-1321-4cce-89ed-acd51dca5c0a",
        "attachments": [],
        "state": "Submitted",
        "objectValues": {
            "current State": "Submitted",
            "created For Email": "this.customer@gmail.com",
            "rma Number-Identifier": "TTO0034",
            "no of Units": 1,
            "jde RMA Number": "",
            "company Name": "Customer Company"
        }
    }
]

 The important properties for each RMA object are described below,

PropertyDescription

id

The id of the RMA that is required to specify when updating it

attachmentscontains an array of attachment details including the attachment url, id, name and visibility

state

The current state of the RMA

objectValues

An object that contains the field values as defined by the list view. The fields in this object are the fields defined on the list view. The type of the field value depends on the type of the field created in TeamTracks.

 Supported Arguments

LastModifiedTime

To get only objects modified since a specified datetime (eg: to only get objects that were modified since the last API call), use the query parameter LastModifiedTime, with value as unix epoch time, in milliseconds. 


It is recommended to use the LastModifiedDate parameter to minimize the size of the response.
The LastModifiedTime paramter uses "Greater than or equal to" operator by definition, therefore the paramter in the url should use the "=" operator.

The final url will look like below.

https://api.team-tracks.com/object/{viewID}?LastModifiedTime=1666816923042