Get Org Entities

Retrieves the details of zones, stores, store servers, concepts or TILLs configured for the current organization. By default, it fetches up to 200 entities.

To get child entities

https://{{host}}/v1.1/organization/entities?type={type}&parent_identifier_type={parent_type}&parent_identifier_value={identifier_value}

Request parameter

ParameterDescription
type*Pass the entity type to retrieve. Value: STORE, STR_SERVER (store server), TILL, ZONE, CONCEPT. Pass example, pass STORE to retrieve store details.
scopePass STORE_CUSTOM_FIELDS or ZONE_CUSTOM_FIELDS to retrieve the list of store level or zone level custom fields.
idPass an entity id as in the org_entities table (in database) to get the details of that particular entity.
parent_identifier_typeParent entity type to fetch its child entities. Values: STORE_CODE, STORE_ID, STORE_EXTERNAL_ID, CONCEPT_CODE, CONCEPT_ID.
parent_identifier_valuePass the respective identifier value. For example, parent_identifier_type=CONCEPT_CODE&parent_identifier_value=supermarket.
include_parentPass true to retrieve the details of the parent entity (parent zone or concept). This is applicable only for type zone or concept.
`sub_entities_countLimit the number of sub-entities to retrieve for each entity.
detailsPass basic to see only basic information excluding currency, time-zone, and language information.
exclude_localePass 1 to exclude time zone details (timezones), 0 to retrieve timezones > base_timezone details of an entity. Default value is 0.
start_idFetches entities that are above the offset number you pass. Offset is the position of the entity in the db record. The value is assigned based on the sequence of creation. For example, start_id=10 retrieves all the entities from record number 11.
limitLimit the number of entities to retrieve. Default value is 500.
modified_sinceRetrieves the entities that are modified on or after a specific date. Pass the date in YYYY-MM-DD format.
active_onlyPass true to retrieve the list of only active stores.

Response parameter

ParameterDescription
limitMaximum number of items returned per page.
offsetOffset for the starting record of the result.
totalTotal number of entities found.
successIndicates if the request was successful.
codeStatus code for the response.
messageMessage describing the status of the request.
idUnique identifier for the store.
is_activeIndicates if the store is active (1 = Yes).
codeCode representing the store.
nameName of the store.
descriptionDescription of the store.
last_updated_byIdentifier of the user who last updated the entity.
last_updated_onDate and time when the entity was last updated.
custom_fields.fieldCustom fields associated with the entity. Each field contains name and value.
time_zone_idIdentifier for the store's timezone.
currency_idIdentifier for the store's currency.
language_idIdentifier for the store's language.
labelLabel for the base timezone of the store.
offsetOffset for the base timezone of the store.
symbolSymbol for the base currency of the store.
labelLabel for the base currency of the store.
language_codeCode representing the store's language.
language_localeLocale associated with the store's language.
base_language.langBase language of the store.
base_language.localeLocale of the base language of the store.
external_idExternal identifier for the store.
external_id_1Additional external identifier for the store.
external_id_2Another additional external identifier for the store.
mobileMobile number associated with the store.
channelChannel where the store operates (e.g., instore).
land_lineLandline number associated with the store.
emailEmail address associated with the store.
addressAddress of the store.
latitudeLatitude coordinate of the store's location.
longitudeLongitude coordinate of the store's location.
typeType of the entity (e.g., STORE).
Language
Authorization
Basic
base64
:
URL
Click Try It! to start a request and see the response here!