Skip to main content

Store

Access store information including store details, terminals, inventories, doctors, taxes, and webhooks.

Base URL: /api/v1/partner/store

Endpoints Overview

MethodEndpointDescription
GET/Get Store Info
GET/doctorsGet Store Info
GET/terminalsGet all active terminals
GET/inventoriesGet all active Inventories
POST/webHookCreate web hook for plugin
GET/taxesGet tax information

Get Store Info

GET /api/v1/partner/store

Retrieve the store's configuration and details. The store is determined by the authentication headers — no parameters are needed.

Response

Returns a StoreInfoResult object.

FieldTypeRequiredDescription
shopShopNoShop
contractContractNoContract
companyLogoURLstringNoCompany Logo U R L

Get Store Info

GET /api/v1/partner/store/doctors

Search for doctors associated with the store. Use the term query parameter for free-text search.

Query Parameters

ParameterTypeRequiredDescription
termstringNoterm

Response

Returns a paginated SearchResult of Doctor objects.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
importIdstringNoImport identifier
firstNamestringYesFirst name
lastNamestringYesLast name
licensestringYesLicense
websitestringNoWebsite URL
phoneNumberstringNoPhone Number
emailstringNoEmail address
faxstringNoFax
degreestringNoDegree
statestringNoState
searchTextstringNoSearch Text
addressAddressNoAddress
activebooleanNoWhether active
notesNote[]NoNotes
assetsCompanyAsset[]NoAssets
deaNumberstringNoDea Number
npiNumberstringNoNpi Number

Get all active terminals

GET /api/v1/partner/store/terminals

Retrieve all active POS terminals for the store. Supports pagination with start and limit parameters.

Query Parameters

ParameterTypeRequiredDescription
startintegerNoNumber of records to skip
limitintegerNoMaximum records to return

Response

Returns a paginated SearchResult of Terminal objects.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
activebooleanNoWhether active
deviceIdstringNoDevice identifier
namestringNoName
deviceModelstringNoDevice Model
deviceVersionstringNoDevice Version
deviceNamestringNoDevice Name
appVersionstringNoApp Version
deviceTokenstringNoDevice Token
deviceTypestringNoDevice Type
assignedInventoryIdstringNoAssigned Inventory identifier
cvAccountIdstringNoCv Account identifier
currentEmployeeIdstringNoCurrent Employee identifier
terminalTypestringNoTerminal Type. One of: NotAssigned, WalkIn, Delivery, SelfCheckout (default: NotAssigned)
posTerminalstringNoPos Terminal
regionIdstringNoRegion identifier
creditCardReaderCreditCardReaderNoCredit Card Reader
onPremEnabledbooleanNoOn Prem Enabled (default: false)
brandIdsstring[]NoBrand Ids
terminalLocationsTerminalLocation[]NoTerminal Locations
deviceDetailsdevicedetail[]NoDevice Details
deviceIdstringNoDevice identifier
versionstringNoVersion (default: 1.0.0)
deviceTokenstringNoDevice Token
deviceTypestringNoDevice Type. One of: Android, iOS, Desktop, Web (default: iOS)
deviceVersionstringNoDevice Version
sdkVersionstringNoSdk Version
deviceModelstringNoDevice Model
deviceNamestringNoDevice Name
activebooleanNoWhether active

Get all active Inventories

GET /api/v1/partner/store/inventories

Retrieve all active inventory rooms/locations for the store. Supports pagination with start and limit parameters.

Query Parameters

ParameterTypeRequiredDescription
startintegerNoNumber of records to skip
limitintegerNoMaximum records to return

Response

Returns a paginated SearchResult of Inventory objects.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
typestringNoType. One of: Storage, Field, Quarantine (default: Field)
namestringNoName
activebooleanNoWhether active (default: true)
regionIdsstring[]NoRegion Ids
externalIdstringNoExternal system identifier
dryRoombooleanNoDry Room (default: true)
quantitynumberNoQuantity
complianceInvRoomNamestringNoCompliance Inv Room Name
complianceInvRoomIdintegerNoCompliance Inv Room identifier

Create web hook for plugin

POST /api/v1/partner/store/webHook

Create one or more webhook registrations for a partner plugin. Send a JSON array of PartnerWebHookAddRequest objects to register multiple webhooks in a single call.

Request Body

Accepts an array of PartnerWebHookAddRequest objects.

FieldTypeRequiredDescription
urlstringNoUrl
shopIdstringNoShop identifier
webHookUrlsstring[]YesWeb Hook Urls

Response

Returns a list of PartnerWebHook objects.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
urlstringNoUrl
webHookTypestringNoWeb Hook Type. One of: NEW_CONSUMER_ORDER, NEW_CONSUMER_SIGNUP, UPDATE_CONSUMER_ORDER, UPDATE_CONSUMER_USER, NEW_MEMBER, UPDATE_MEMBER, CREATE_TRANSACTION, UPDATE_TRANSACTION, CANCEL_TRANSACTION, COMPLETE_TRANSACTION, UPDATE_PRODUCT
webHookUrlsstring[]NoWeb Hook Urls

Get tax information

GET /api/v1/partner/store/taxes

Retrieve the store's tax configuration, including tax names, rates, and display settings.

Response

Returns a list of TaxInfoResult objects.

FieldTypeRequiredDescription
namestringNoName