Skip to content
Ideasoft
Getting Started

Making Requests

Set your store domain

Every request goes to your own store's domain: https://<store>.myideasoft.com or your own attached domain. The examples show the your-store.myideasoft.com placeholder; to try a request, click Test and type your domain in the dialog's URL field — it is stored in your browser and reused for all requests. The settings icon next to the endpoint URL ("Edit server variables") does the same.

Headers

Code
Authorization: Bearer <access_token> Content-Type: application/json

Requests with a body (POST/PUT) always send JSON.

Pagination and sorting

List endpoints support the following query parameters:

ParameterDescription
pagePage number (starts at 1)
limitRecords per page
sortSort field; prefix the field name with - for descending order (e.g. sort=-createdAt)

Filters

ParameterDescription
idSingle record identifier
idsMultiple identifiers (comma-separated)
sinceIdRecords after the given identifier
qGeneral search query
sText search

Total count

Most list endpoints offer a /count variant that returns the total number of records for the same filter parameters (e.g. GET /admin-api/product/count).

Date formats

  • Date: yyyy-mm-dd (e.g. 2026-01-01)
  • Date + time: yyyy-mm-dd hh:mm:ss (e.g. 2026-01-01 12:00:00)

Value ranges

Field-level constraints (e.g. the upper bound of limit) are documented on each endpoint's reference page.

Last modified on