Search

getObjects

Retrieve your custom objects.

ERPLY has an object storage where you can store custom data for plug-ins, integrations etc.

For other object storage functions, see getObjects, saveObject, deleteObject (which allow to manipulate whole objects), and incrementAttributeValue, decrementAttributeValue — which provide a way to atomically increment or decrement one numeric field of a specific object (eg. to implement a counter).

Input parameters

Parameter nameDescriptionPossible valueRequired
objectIDObject ID. Retrieve one specific object.Integer
groupGroup name. Retrieve all objects from one specific group.

A group is like a "database table" for your custom relational objects. All objects in one group should have approximately the same data fields.

Object IDs are globally unique (ie., not per-group unique); if you look up an object by ID, leave the "group" field unspecified.
String
searchAttributeName1
searchAttributeValue1
Search for an object that has a specific field value.

For example, if you using object storage to store vehicles (that have a license plate number), you may look up a vehicle with the following query: searchAttributeName1 = "licensePlate", searchAttributeValue1 = "ABC1234".

It is possible to use only one attribute filter right now, although searching by multiple attributes may be supported in the future.

partnerKeyTo use object storage, you need an API partner key. Contact ERPLY customer support to get one.String yes
recordsOnPageNumber of records API should return. By default 20, at most 100.Integer
pageNoAPI returns at most recordsOnPage items at a time. To retrive the next recordsOnPage items, send a new request with pageNo incremented by one. By default, API returns "page 1".Integer

Response

Field nameTypeDescription
objectIDInteger
groupString
attributesArrayArray, each item in which has the following parameters:

attributeName - String - name of the attribute
attributeType - String - type of the attribute
attributeValue - value of the attribute.