# Making Requests

:::note{title="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

```http
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:

| Parameter | Description |
|---|---|
| `page` | Page number (starts at 1) |
| `limit` | Records per page |
| `sort` | Sort field; prefix the field name with `-` for descending order (e.g. `sort=-createdAt`) |

## Filters

| Parameter | Description |
|---|---|
| `id` | Single record identifier |
| `ids` | Multiple identifiers (comma-separated) |
| `sinceId` | Records after the given identifier |
| `q` | General search query |
| `s` | Text 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`)

:::warning{title="Value ranges"}
Field-level constraints (e.g. the upper bound of `limit`) are documented on each endpoint's reference page.
:::
