{
  "info": {
    "_postman_id": "719f2bb5-d336-5a4e-ae41-17af12e883f9",
    "name": "POS GROVE POS API — all endpoints",
    "description": "Every endpoint of the POS GROVE REST API, one folder per category.\n\n**Setup**\n1. Set the collection variable `baseUrl` to your POS GROVE address followed by `/api/v1`.\n2. Either paste an API key (Online store → API & Webhooks) into `accessToken`, or run **Get an access token** (in the *Sign in* or *Authentication* folder): it signs in with a username and password and saves the token for you (valid 12 hours).\n3. Send any request. A test checks the `{ success }` envelope on every answer.\n\nAll responses use `{ success, message, data, meta }`; errors use `{ success: false, message, error: { code, details, requestId } }`. Lists accept `page`, `limit`, `sort` and `fields`.\n\nReference: https://posgrove.com/docs/pos-api",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{accessToken}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "test",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// POS GROVE APIs answer { success, message, data } (or { success: false, error, message }).",
          "pm.test(\"Response is JSON\", function () { pm.response.to.be.json; });",
          "pm.test(\"Envelope has a success flag\", function () {",
          "  var b = pm.response.json();",
          "  pm.expect(b).to.have.property(\"success\");",
          "  if (pm.response.code < 400) pm.expect(b.success).to.eql(true);",
          "});"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://your-store.example.com/api/v1",
      "type": "string",
      "description": "Your POS GROVE address followed by /api/v1, e.g. https://shop.example.com/api/v1"
    },
    {
      "key": "accessToken",
      "value": "",
      "type": "string",
      "description": "An API key, or the token saved by the Get an access token request."
    }
  ],
  "item": [
    {
      "name": "Authentication",
      "description": "Get an access token with a username and password, or use an API key created in Online store > API & Webhooks. Send either as `Authorization: Bearer <token>` (API keys may also use `X-API-Key`).",
      "item": [
        {
          "name": "Get an access token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/auth/token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "auth",
                "token"
              ]
            },
            "description": "Signs in with a username and password (and the 6-digit code when two-factor sign-in is on) and returns a bearer token valid for 12 hours. The token is shown only once. Five wrong passwords in a row disable the account, as on the sign-in page.\n\nNo authentication needed.\n\n`POST /auth/token` · operationId `auth.token`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"username\": \"jane\",\n  \"password\": \"••••••••\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/auth/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "auth",
                    "token"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"username\": \"jane\",\n  \"password\": \"••••••••\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"token\": \"mtk_<token shown once>\",\n    \"tokenType\": \"Bearer\",\n    \"expiresAt\": \"2026-10-02T21:30:00.000Z\",\n    \"expiresIn\": 43200,\n    \"user\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"username\": \"jane\",\n      \"name\": \"Jane Doe\"\n    }\n  }\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "var body = {};",
                  "try { body = pm.response.json(); } catch (e) {}",
                  "if (body && body.data && body.data.token) {",
                  "  pm.collectionVariables.set(\"accessToken\", body.data.token);",
                  "  if (pm.environment && pm.environment.has(\"accessToken\")) pm.environment.set(\"accessToken\", body.data.token);",
                  "  console.log(\"POS GROVE: access token saved to {{accessToken}} (valid until \" + body.data.expiresAt + \")\");",
                  "}",
                  "pm.test(\"Access token received\", function () { pm.expect(body.data && body.data.token).to.be.a(\"string\"); });"
                ]
              }
            }
          ]
        },
        {
          "name": "Current user and credential",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/auth/me",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "auth",
                "me"
              ]
            },
            "description": "The user the request acts as, their permissions, and the credential used (type, name, scopes, expiry).\n\nAny signed-in user.\n\nScope: `auth:read`.\n\n`GET /auth/me` · operationId `auth.me`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/auth/me",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "auth",
                    "me"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"user\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"username\": \"jane\",\n      \"name\": \"Jane Doe\",\n      \"email\": \"jane@example.com\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"storeName\": \"Main Street\",\n      \"isSuperAdmin\": false,\n      \"permissions\": {\n        \"pos\": {\n          \"pos\": \"1\",\n          \"products\": \"1\",\n          \"sales\": \"1\"\n        },\n        \"crm\": {\n          \"customers\": \"1\"\n        }\n      },\n      \"twoFactorEnabled\": true\n    },\n    \"credential\": {\n      \"type\": \"token\",\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e517\",\n      \"name\": \"Warehouse scanner\",\n      \"scopes\": [\n        \"*\"\n      ],\n      \"expiresAt\": \"2026-10-02T21:30:00.000Z\"\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "List your access tokens",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/auth/tokens",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "auth",
                "tokens"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ]
            },
            "description": "Tokens you created with /auth/token (not their values).\n\nAny signed-in user.\n\nScope: `auth:read`.\n\n`GET /auth/tokens` · operationId `auth.tokens.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/auth/tokens",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "auth",
                    "tokens"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e517\",\n      \"name\": \"Warehouse scanner\",\n      \"scopes\": [\n        \"*\"\n      ],\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"expiresAt\": \"2026-10-02T21:30:00.000Z\",\n      \"lastUsedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"lastIp\": \"102.89.1.20\",\n      \"revoked\": false,\n      \"current\": true\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Revoke one of your tokens",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/auth/tokens/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "auth",
                "tokens",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^([a-f0-9]{24}|current)$"
                }
              ]
            },
            "description": "Revoked tokens stop working at once. Use the id `current` to revoke the token making the request (sign out).\n\nAny signed-in user.\n\nScope: `auth:read`.\n\n`DELETE /auth/tokens/{id}` · operationId `auth.tokens.revoke`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/auth/tokens/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "auth",
                    "tokens",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^([a-f0-9]{24}|current)$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e517\",\n    \"revoked\": true\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Users",
      "description": "Staff accounts. Password hashes, two-factor secrets and session data are never returned. API keys need the `admin` scope.",
      "item": [
        {
          "name": "List users",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/users",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "Only active (true) or disabled (false) users.",
                  "disabled": true
                },
                {
                  "key": "storeId",
                  "value": "",
                  "description": "Only users assigned to this store.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `admin.admin` or `admin.view`.\n\nScope: `admin:read`.\n\n`GET /users` · operationId `users.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/users",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "users"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "active",
                      "value": "",
                      "description": "Only active (true) or disabled (false) users.",
                      "disabled": true
                    },
                    {
                      "key": "storeId",
                      "value": "",
                      "description": "Only users assigned to this store.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"username\": \"jane\",\n      \"name\": \"Jane Doe\",\n      \"email\": \"jane@example.com\",\n      \"mobile\": \"08012345678\",\n      \"address\": \"\",\n      \"active\": true,\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"storeName\": \"Main Street\",\n      \"isSuperAdmin\": false,\n      \"lastLoginAt\": \"2026-10-02T14:05:00.000Z\",\n      \"passwordChangedAt\": \"2026-10-01T09:30:00.000Z\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Create a user",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/users",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users"
              ]
            },
            "description": "New users start with no permissions. They are created disabled unless `active` is true and you may approve users (admin.switch), as on the Admin page.\n\nPermission: `admin.add`.\n\nScope: `admin:write`.\n\n`POST /users` · operationId `users.create`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"username\": \"\",\n  \"name\": \"\",\n  \"email\": \"jane@example.com\",\n  \"mobile\": \"\",\n  \"password\": \"\",\n  \"storeId\": \"\",\n  \"active\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/users",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "users"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"username\": \"\",\n  \"name\": \"\",\n  \"email\": \"jane@example.com\",\n  \"mobile\": \"\",\n  \"password\": \"\",\n  \"storeId\": \"\",\n  \"active\": false\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n    \"username\": \"jane\",\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\",\n    \"mobile\": \"08012345678\",\n    \"address\": \"\",\n    \"active\": true,\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"isSuperAdmin\": false,\n    \"lastLoginAt\": \"2026-10-02T14:05:00.000Z\",\n    \"passwordChangedAt\": \"2026-10-01T09:30:00.000Z\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"permissions\": {\n      \"pos\": {\n        \"pos\": \"1\",\n        \"products\": \"1\",\n        \"sales\": \"1\"\n      },\n      \"crm\": {\n        \"customers\": \"1\"\n      }\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "Get a user (with permissions)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/users/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `admin.admin` or `admin.view`.\n\nScope: `admin:read`.\n\n`GET /users/{id}` · operationId `users.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/users/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "users",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n    \"username\": \"jane\",\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\",\n    \"mobile\": \"08012345678\",\n    \"address\": \"\",\n    \"active\": true,\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"isSuperAdmin\": false,\n    \"lastLoginAt\": \"2026-10-02T14:05:00.000Z\",\n    \"passwordChangedAt\": \"2026-10-01T09:30:00.000Z\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"permissions\": {\n      \"pos\": {\n        \"pos\": \"1\",\n        \"products\": \"1\",\n        \"sales\": \"1\"\n      },\n      \"crm\": {\n        \"customers\": \"1\"\n      }\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "Update a user",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/users/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Send only the fields to change. Changing `active` needs admin.switch; you cannot disable your own account.\n\nPermission: `admin.edit`.\n\nScope: `admin:write`.\n\nBody fields (send only the ones you change):\n- `name` (string)\n- `email` (string)\n- `mobile` (string)\n- `address` (string)\n- `storeId` (string)\n- `active` (boolean)\n\n`PATCH /users/{id}` · operationId `users.update`",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/users/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "users",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n    \"username\": \"jane\",\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\",\n    \"mobile\": \"08012345678\",\n    \"address\": \"\",\n    \"active\": true,\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"isSuperAdmin\": false,\n    \"lastLoginAt\": \"2026-10-02T14:05:00.000Z\",\n    \"passwordChangedAt\": \"2026-10-01T09:30:00.000Z\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"permissions\": {\n      \"pos\": {\n        \"pos\": \"1\",\n        \"products\": \"1\",\n        \"sales\": \"1\"\n      },\n      \"crm\": {\n        \"customers\": \"1\"\n      }\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "Replace a user's permissions",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/users/:id/permissions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users",
                ":id",
                "permissions"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Send the complete set, e.g. `{ \"permissions\": { \"pos\": { \"pos\": true, \"products\": true }, \"crm\": { \"customers\": true } } }`. Menus and keys are listed by GET /admin/permissions. You cannot change your own permissions.\n\nPermission: `admin.permission`.\n\nScope: `admin:write`.\n\n`PUT /users/{id}/permissions` · operationId `users.permissions`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"permissions\": {}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/users/:id/permissions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "users",
                    ":id",
                    "permissions"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"permissions\": {}\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n    \"username\": \"jane\",\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\",\n    \"mobile\": \"08012345678\",\n    \"address\": \"\",\n    \"active\": true,\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"isSuperAdmin\": false,\n    \"lastLoginAt\": \"2026-10-02T14:05:00.000Z\",\n    \"passwordChangedAt\": \"2026-10-01T09:30:00.000Z\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"permissions\": {\n      \"pos\": {\n        \"pos\": \"1\",\n        \"products\": \"1\",\n        \"sales\": \"1\"\n      },\n      \"crm\": {\n        \"customers\": \"1\"\n      }\n    }\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Stores",
      "description": "Stores (branches). Without the pos.stores permission you only see the store your account is assigned to. API keys need the `pos` scope.",
      "item": [
        {
          "name": "List stores",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/stores",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "stores"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Any signed-in user.\n\nScope: `pos:read`.\n\n`GET /stores` · operationId `stores.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/stores",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "stores"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"name\": \"Main Street\",\n      \"type\": \"retail\",\n      \"status\": \"active\",\n      \"address\": \"12 Market Road\",\n      \"city\": \"Lagos\",\n      \"state\": \"Lagos\",\n      \"zip\": \"\",\n      \"phone\": \"08012345678\",\n      \"email\": \"main@example.com\",\n      \"manager\": \"Jane Doe\",\n      \"timezone\": \"Africa/Lagos\",\n      \"currencySymbol\": \"NGN\",\n      \"vatRate\": 7.5,\n      \"stockControl\": true,\n      \"paymentBeforeOrder\": true,\n      \"onlineOrders\": true,\n      \"shipping\": false,\n      \"confirmationEmails\": true,\n      \"businessHours\": null,\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a store",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/stores/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "stores",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Any signed-in user.\n\nScope: `pos:read`.\n\n`GET /stores/{id}` · operationId `stores.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/stores/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "stores",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"name\": \"Main Street\",\n    \"type\": \"retail\",\n    \"status\": \"active\",\n    \"address\": \"12 Market Road\",\n    \"city\": \"Lagos\",\n    \"state\": \"Lagos\",\n    \"zip\": \"\",\n    \"phone\": \"08012345678\",\n    \"email\": \"main@example.com\",\n    \"manager\": \"Jane Doe\",\n    \"timezone\": \"Africa/Lagos\",\n    \"currencySymbol\": \"NGN\",\n    \"vatRate\": 7.5,\n    \"stockControl\": true,\n    \"paymentBeforeOrder\": true,\n    \"onlineOrders\": true,\n    \"shipping\": false,\n    \"confirmationEmails\": true,\n    \"businessHours\": null,\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Products",
      "description": "Products, variants, prices and stock. Reading needs pos.products or pos.pos; changes need pos.products. Cost prices are only shown with pos.products. API keys need the `pos` scope.",
      "item": [
        {
          "name": "List products",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "brand",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: active, inactive, discontinued, draft.",
                  "disabled": true
                },
                {
                  "key": "sku",
                  "value": "",
                  "description": "Exact product or variant SKU.",
                  "disabled": true
                },
                {
                  "key": "barcode",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "stock",
                  "value": "",
                  "description": "Products with at least one variant at this stock level. One of: out, low, in.",
                  "disabled": true
                },
                {
                  "key": "expiry",
                  "value": "",
                  "description": "\"expiring\" = within the configured window. One of: expired, expiring, none.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `pos.products` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /products` · operationId `products.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "brand",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: active, inactive, discontinued, draft.",
                      "disabled": true
                    },
                    {
                      "key": "sku",
                      "value": "",
                      "description": "Exact product or variant SKU.",
                      "disabled": true
                    },
                    {
                      "key": "barcode",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "stock",
                      "value": "",
                      "description": "Products with at least one variant at this stock level. One of: out, low, in.",
                      "disabled": true
                    },
                    {
                      "key": "expiry",
                      "value": "",
                      "description": "\"expiring\" = within the configured window. One of: expired, expiring, none.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e503\",\n      \"name\": \"Rice 5kg\",\n      \"sku\": \"RICE5\",\n      \"barcode\": \"6151234567890\",\n      \"description\": \"Long-grain parboiled rice.\",\n      \"category\": \"Food\",\n      \"subcategory\": \"Grains\",\n      \"kitchenCategory\": \"\",\n      \"brand\": \"Golden Penny\",\n      \"status\": \"active\",\n      \"tags\": [\n        \"staple\"\n      ],\n      \"images\": [],\n      \"weight\": 5,\n      \"expiryDate\": \"2027-06-30\",\n      \"expiryStatus\": \"valid\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"storeName\": \"Main Street\",\n      \"totalQuantity\": 42,\n      \"variants\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e504\",\n          \"variantId\": \"v_1a2b3c4d5e6f\",\n          \"name\": \"Rice 5kg\",\n          \"sku\": \"RICE5\",\n          \"price\": 6500,\n          \"compareAtPrice\": 7000,\n          \"currency\": \"NGN\",\n          \"quantity\": 42,\n          \"threshold\": 5,\n          \"stockLevel\": \"in\",\n          \"location\": \"Aisle 3\",\n          \"isActive\": true,\n          \"attributes\": {\n            \"size\": \"5kg\"\n          },\n          \"cost\": 5200\n        }\n      ],\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Create a product",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products"
              ]
            },
            "description": "Creates the product in your store (or `storeId`, with pos.stores). Images are added in the app.\n\nPermission: `pos.products`.\n\nScope: `pos:write`.\n\n`POST /products` · operationId `products.create`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"sku\": \"\",\n  \"category\": \"\",\n  \"status\": \"active\",\n  \"variants\": [\n    {\n      \"price\": 0,\n      \"quantity\": 0\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"\",\n  \"sku\": \"\",\n  \"category\": \"\",\n  \"status\": \"active\",\n  \"variants\": [\n    {\n      \"price\": 0,\n      \"quantity\": 0\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e503\",\n    \"name\": \"Rice 5kg\",\n    \"sku\": \"RICE5\",\n    \"barcode\": \"6151234567890\",\n    \"description\": \"Long-grain parboiled rice.\",\n    \"category\": \"Food\",\n    \"subcategory\": \"Grains\",\n    \"kitchenCategory\": \"\",\n    \"brand\": \"Golden Penny\",\n    \"status\": \"active\",\n    \"tags\": [\n      \"staple\"\n    ],\n    \"images\": [],\n    \"weight\": 5,\n    \"expiryDate\": \"2027-06-30\",\n    \"expiryStatus\": \"valid\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"totalQuantity\": 42,\n    \"variants\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e504\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"name\": \"Rice 5kg\",\n        \"sku\": \"RICE5\",\n        \"price\": 6500,\n        \"compareAtPrice\": 7000,\n        \"currency\": \"NGN\",\n        \"quantity\": 42,\n        \"threshold\": 5,\n        \"stockLevel\": \"in\",\n        \"location\": \"Aisle 3\",\n        \"isActive\": true,\n        \"attributes\": {\n          \"size\": \"5kg\"\n        },\n        \"cost\": 5200\n      }\n    ],\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Get a product",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.products` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /products/{id}` · operationId `products.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e503\",\n    \"name\": \"Rice 5kg\",\n    \"sku\": \"RICE5\",\n    \"barcode\": \"6151234567890\",\n    \"description\": \"Long-grain parboiled rice.\",\n    \"category\": \"Food\",\n    \"subcategory\": \"Grains\",\n    \"kitchenCategory\": \"\",\n    \"brand\": \"Golden Penny\",\n    \"status\": \"active\",\n    \"tags\": [\n      \"staple\"\n    ],\n    \"images\": [],\n    \"weight\": 5,\n    \"expiryDate\": \"2027-06-30\",\n    \"expiryStatus\": \"valid\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"totalQuantity\": 42,\n    \"variants\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e504\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"name\": \"Rice 5kg\",\n        \"sku\": \"RICE5\",\n        \"price\": 6500,\n        \"compareAtPrice\": 7000,\n        \"currency\": \"NGN\",\n        \"quantity\": 42,\n        \"threshold\": 5,\n        \"stockLevel\": \"in\",\n        \"location\": \"Aisle 3\",\n        \"isActive\": true,\n        \"attributes\": {\n          \"size\": \"5kg\"\n        },\n        \"cost\": 5200\n      }\n    ],\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Update product details",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Send only the fields to change. Prices and stock are changed per variant (see below).\n\nPermission: `pos.products`.\n\nScope: `pos:write`.\n\n`PATCH /products/{id}` · operationId `products.update`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"active\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"status\": \"active\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e503\",\n    \"name\": \"Rice 5kg\",\n    \"sku\": \"RICE5\",\n    \"barcode\": \"6151234567890\",\n    \"description\": \"Long-grain parboiled rice.\",\n    \"category\": \"Food\",\n    \"subcategory\": \"Grains\",\n    \"kitchenCategory\": \"\",\n    \"brand\": \"Golden Penny\",\n    \"status\": \"active\",\n    \"tags\": [\n      \"staple\"\n    ],\n    \"images\": [],\n    \"weight\": 5,\n    \"expiryDate\": \"2027-06-30\",\n    \"expiryStatus\": \"valid\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"totalQuantity\": 42,\n    \"variants\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e504\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"name\": \"Rice 5kg\",\n        \"sku\": \"RICE5\",\n        \"price\": 6500,\n        \"compareAtPrice\": 7000,\n        \"currency\": \"NGN\",\n        \"quantity\": 42,\n        \"threshold\": 5,\n        \"stockLevel\": \"in\",\n        \"location\": \"Aisle 3\",\n        \"isActive\": true,\n        \"attributes\": {\n          \"size\": \"5kg\"\n        },\n        \"cost\": 5200\n      }\n    ],\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Update a variant (price, threshold…)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id/variants/:variantId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id",
                "variants",
                ":variantId"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                },
                {
                  "key": "variantId",
                  "value": "",
                  "description": ""
                }
              ]
            },
            "description": "`variantId` may be the variant id, its variantId or its SKU. Use the stock endpoint to change quantities.\n\nPermission: `pos.products`.\n\nScope: `pos:write`.\n\nBody fields (send only the ones you change):\n- `name` (string)\n- `price` (number)\n- `compareAtPrice` (number)\n- `cost` (number)\n- `threshold` (integer)\n- `location` (string)\n- `isActive` (boolean)\n\n`PATCH /products/{id}/variants/{variantId}` · operationId `products.variant.update`",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products/:id/variants/:variantId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products",
                    ":id",
                    "variants",
                    ":variantId"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    },
                    {
                      "key": "variantId",
                      "value": "",
                      "description": ""
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e503\",\n    \"name\": \"Rice 5kg\",\n    \"sku\": \"RICE5\",\n    \"barcode\": \"6151234567890\",\n    \"description\": \"Long-grain parboiled rice.\",\n    \"category\": \"Food\",\n    \"subcategory\": \"Grains\",\n    \"kitchenCategory\": \"\",\n    \"brand\": \"Golden Penny\",\n    \"status\": \"active\",\n    \"tags\": [\n      \"staple\"\n    ],\n    \"images\": [],\n    \"weight\": 5,\n    \"expiryDate\": \"2027-06-30\",\n    \"expiryStatus\": \"valid\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"totalQuantity\": 42,\n    \"variants\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e504\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"name\": \"Rice 5kg\",\n        \"sku\": \"RICE5\",\n        \"price\": 6500,\n        \"compareAtPrice\": 7000,\n        \"currency\": \"NGN\",\n        \"quantity\": 42,\n        \"threshold\": 5,\n        \"stockLevel\": \"in\",\n        \"location\": \"Aisle 3\",\n        \"isActive\": true,\n        \"attributes\": {\n          \"size\": \"5kg\"\n        },\n        \"cost\": 5200\n      }\n    ],\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Adjust stock",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id/stock",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id",
                "stock"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Either `adjustment` (e.g. 10 received, -2 damaged) or `quantity` (stock count). Stock never goes below zero; an adjustment that would is refused with 409. Low and out-of-stock alerts are raised as in the app.\n\nPermission: `pos.products`.\n\nScope: `pos:write`.\n\n`POST /products/{id}/stock` · operationId `products.stock`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"Stock count\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/products/:id/stock",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "products",
                    ":id",
                    "stock"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"reason\": \"Stock count\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n    \"variantId\": \"66f1c2a9e4b0a1b2c3d4e504\",\n    \"before\": 42,\n    \"after\": 52,\n    \"stockLevel\": \"in\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Inventory alerts summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/inventory/summary",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "inventory",
                "summary"
              ],
              "query": [
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                },
                {
                  "key": "days",
                  "value": "",
                  "description": "Expiring window in days.",
                  "disabled": true
                }
              ]
            },
            "description": "Counts of expired, expiring, out-of-stock and low-stock items (as on the inventory dashboard).\n\nPermission: `pos.products` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /inventory/summary` · operationId `inventory.summary`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/inventory/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "inventory",
                    "summary"
                  ],
                  "query": [
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    },
                    {
                      "key": "days",
                      "value": "",
                      "description": "Expiring window in days.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"days\": 30,\n    \"expired\": 1,\n    \"expiring\": 3,\n    \"out\": 2,\n    \"low\": 5,\n    \"stores\": [\n      \"66f1c2a9e4b0a1b2c3d4e501\"\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Inventory alert list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/inventory/report?type=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "inventory",
                "report"
              ],
              "query": [
                {
                  "key": "type",
                  "value": "",
                  "description": "One of: expired, expiring, out, low.",
                  "disabled": false
                },
                {
                  "key": "days",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                }
              ]
            },
            "description": "One row per affected product (expiry) or variant (stock).\n\nPermission: `pos.products` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /inventory/report` · operationId `inventory.report`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/inventory/report?type=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "inventory",
                    "report"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "",
                      "description": "One of: expired, expiring, out, low.",
                      "disabled": false
                    },
                    {
                      "key": "days",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n      \"name\": \"Rice 5kg\",\n      \"sku\": \"RICE5\",\n      \"category\": \"Food\",\n      \"variant\": \"Rice 5kg\",\n      \"variantSku\": \"RICE5\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"storeName\": \"Main Street\",\n      \"status\": \"low\",\n      \"quantity\": 4,\n      \"threshold\": 5,\n      \"location\": \"Aisle 3\",\n      \"expiryDate\": \"2027-06-30T00:00:00.000Z\",\n      \"daysLeft\": 271,\n      \"type\": \"low\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Orders & refunds",
      "description": "Sales orders and refunds. Reading needs pos.sales or pos.pos; selling needs pos.pos. Orders are created in your store with catalogue prices. API keys need the `pos` scope.",
      "item": [
        {
          "name": "List orders",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: pending, confirmed, processing, shipped, delivered, cancelled, refunded, on_hold.",
                  "disabled": true
                },
                {
                  "key": "paymentStatus",
                  "value": "",
                  "description": "One of: pending, authorized, paid, partially_refunded, refunded, failed, cancelled.",
                  "disabled": true
                },
                {
                  "key": "customerId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "orderNumber",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "source",
                  "value": "",
                  "description": "One of: pos, web, mobile, api, other.",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `pos.sales` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /orders` · operationId `orders.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: pending, confirmed, processing, shipped, delivered, cancelled, refunded, on_hold.",
                      "disabled": true
                    },
                    {
                      "key": "paymentStatus",
                      "value": "",
                      "description": "One of: pending, authorized, paid, partially_refunded, refunded, failed, cancelled.",
                      "disabled": true
                    },
                    {
                      "key": "customerId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "orderNumber",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "source",
                      "value": "",
                      "description": "One of: pos, web, mobile, api, other.",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n      \"orderNumber\": \"ORD1790904240356987\",\n      \"status\": \"confirmed\",\n      \"source\": \"api\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"storeName\": \"Main Street\",\n      \"customer\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n        \"name\": \"Ada Obi\",\n        \"email\": \"ada@example.com\",\n        \"phone\": \"08098765432\"\n      },\n      \"items\": [\n        {\n          \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n          \"variantId\": \"v_1a2b3c4d5e6f\",\n          \"sku\": \"RICE5\",\n          \"name\": \"Rice 5kg\",\n          \"quantity\": 2,\n          \"unitPrice\": {\n            \"amount\": 6500,\n            \"currency\": \"NGN\"\n          },\n          \"total\": {\n            \"amount\": 13000,\n            \"currency\": \"NGN\"\n          }\n        }\n      ],\n      \"subtotal\": {\n        \"amount\": 13000,\n        \"currency\": \"NGN\"\n      },\n      \"discount\": null,\n      \"tax\": {\n        \"amount\": 975,\n        \"rate\": 7.5\n      },\n      \"shipping\": null,\n      \"total\": {\n        \"amount\": 13975,\n        \"currency\": \"NGN\"\n      },\n      \"payment\": {\n        \"method\": \"cash\",\n        \"status\": \"paid\",\n        \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n      },\n      \"fulfillmentStatus\": \"unfulfilled\",\n      \"refundStatus\": null,\n      \"staff\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"note\": \"\",\n      \"statusHistory\": [\n        {\n          \"status\": \"confirmed\",\n          \"at\": \"2026-10-02T14:05:00.000Z\",\n          \"by\": \"Jane Doe\",\n          \"note\": null\n        }\n      ],\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Create an order (sale)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders"
              ]
            },
            "description": "Sells products from your store. Prices come from the catalogue and tax from the store VAT rate; coupons, automatic discounts and loyalty points are applied as on the POS screen. When the store takes payment before the order, the order is recorded as paid with `payment.method`.\n\nPermission: `pos.pos`.\n\nScope: `pos:write`.\n\n`POST /orders` · operationId `orders.create`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"productId\": \"\",\n      \"quantity\": 1\n    }\n  ],\n  \"payment\": {\n    \"method\": \"cash\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"productId\": \"\",\n      \"quantity\": 1\n    }\n  ],\n  \"payment\": {\n    \"method\": \"cash\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"status\": \"confirmed\",\n    \"source\": \"api\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"sku\": \"RICE5\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": 6500,\n          \"currency\": \"NGN\"\n        },\n        \"total\": {\n          \"amount\": 13000,\n          \"currency\": \"NGN\"\n        }\n      }\n    ],\n    \"subtotal\": {\n      \"amount\": 13000,\n      \"currency\": \"NGN\"\n    },\n    \"discount\": null,\n    \"tax\": {\n      \"amount\": 975,\n      \"rate\": 7.5\n    },\n    \"shipping\": null,\n    \"total\": {\n      \"amount\": 13975,\n      \"currency\": \"NGN\"\n    },\n    \"payment\": {\n      \"method\": \"cash\",\n      \"status\": \"paid\",\n      \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n    },\n    \"fulfillmentStatus\": \"unfulfilled\",\n    \"refundStatus\": null,\n    \"staff\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"note\": \"\",\n    \"statusHistory\": [\n      {\n        \"status\": \"confirmed\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": null\n      }\n    ],\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"loyalty\": {\n      \"redeemedPoints\": 0,\n      \"redeemedValue\": 0,\n      \"earnedPoints\": 139,\n      \"balance\": 459\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "Get an order",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.sales` or `pos.pos`.\n\nScope: `pos:read`.\n\n`GET /orders/{id}` · operationId `orders.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"status\": \"confirmed\",\n    \"source\": \"api\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"sku\": \"RICE5\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": 6500,\n          \"currency\": \"NGN\"\n        },\n        \"total\": {\n          \"amount\": 13000,\n          \"currency\": \"NGN\"\n        }\n      }\n    ],\n    \"subtotal\": {\n      \"amount\": 13000,\n      \"currency\": \"NGN\"\n    },\n    \"discount\": null,\n    \"tax\": {\n      \"amount\": 975,\n      \"rate\": 7.5\n    },\n    \"shipping\": null,\n    \"total\": {\n      \"amount\": 13975,\n      \"currency\": \"NGN\"\n    },\n    \"payment\": {\n      \"method\": \"cash\",\n      \"status\": \"paid\",\n      \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n    },\n    \"fulfillmentStatus\": \"unfulfilled\",\n    \"refundStatus\": null,\n    \"staff\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"note\": \"\",\n    \"statusHistory\": [\n      {\n        \"status\": \"confirmed\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": null\n      }\n    ],\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Cancel an order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Same rules as the POS screen: orders being prepared, fulfilled or already refunded cannot be cancelled. Paid orders are refunded and loyalty points reversed.\n\nPermission: `pos.pos`.\n\nScope: `pos:write`.\n\nBody fields (send only the ones you change):\n- `reason` (string)\n\n`POST /orders/{id}/cancel` · operationId `orders.cancel`",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders/:id/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders",
                    ":id",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"status\": \"cancelled\",\n    \"source\": \"api\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"sku\": \"RICE5\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": 6500,\n          \"currency\": \"NGN\"\n        },\n        \"total\": {\n          \"amount\": 13000,\n          \"currency\": \"NGN\"\n        }\n      }\n    ],\n    \"subtotal\": {\n      \"amount\": 13000,\n      \"currency\": \"NGN\"\n    },\n    \"discount\": null,\n    \"tax\": {\n      \"amount\": 975,\n      \"rate\": 7.5\n    },\n    \"shipping\": null,\n    \"total\": {\n      \"amount\": 13975,\n      \"currency\": \"NGN\"\n    },\n    \"payment\": {\n      \"method\": \"cash\",\n      \"status\": \"paid\",\n      \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n    },\n    \"fulfillmentStatus\": \"unfulfilled\",\n    \"refundStatus\": null,\n    \"staff\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"note\": \"\",\n    \"statusHistory\": [\n      {\n        \"status\": \"confirmed\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": null\n      },\n      {\n        \"status\": \"cancelled\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": \"Customer changed their mind\"\n      }\n    ],\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Record a payment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "payments"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.pos`.\n\nScope: `pos:write`.\n\n`POST /orders/{id}/payments` · operationId `orders.pay`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 0.01,\n  \"method\": \"cash\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders/:id/payments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders",
                    ":id",
                    "payments"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"amount\": 0.01,\n  \"method\": \"cash\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"status\": \"confirmed\",\n    \"source\": \"api\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"sku\": \"RICE5\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": 6500,\n          \"currency\": \"NGN\"\n        },\n        \"total\": {\n          \"amount\": 13000,\n          \"currency\": \"NGN\"\n        }\n      }\n    ],\n    \"subtotal\": {\n      \"amount\": 13000,\n      \"currency\": \"NGN\"\n    },\n    \"discount\": null,\n    \"tax\": {\n      \"amount\": 975,\n      \"rate\": 7.5\n    },\n    \"shipping\": null,\n    \"total\": {\n      \"amount\": 13975,\n      \"currency\": \"NGN\"\n    },\n    \"payment\": {\n      \"method\": \"cash\",\n      \"status\": \"paid\",\n      \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n    },\n    \"fulfillmentStatus\": \"unfulfilled\",\n    \"refundStatus\": null,\n    \"staff\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"note\": \"\",\n    \"statusHistory\": [\n      {\n        \"status\": \"confirmed\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": null\n      }\n    ],\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Mark an order fulfilled",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/orders/:id/fulfill",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "orders",
                ":id",
                "fulfill"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.shipping` or `pos.pos`.\n\nScope: `pos:write`.\n\n`POST /orders/{id}/fulfill` · operationId `orders.fulfill`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/orders/:id/fulfill",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "orders",
                    ":id",
                    "fulfill"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"status\": \"completed\",\n    \"source\": \"api\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"storeName\": \"Main Street\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"variantId\": \"v_1a2b3c4d5e6f\",\n        \"sku\": \"RICE5\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 2,\n        \"unitPrice\": {\n          \"amount\": 6500,\n          \"currency\": \"NGN\"\n        },\n        \"total\": {\n          \"amount\": 13000,\n          \"currency\": \"NGN\"\n        }\n      }\n    ],\n    \"subtotal\": {\n      \"amount\": 13000,\n      \"currency\": \"NGN\"\n    },\n    \"discount\": null,\n    \"tax\": {\n      \"amount\": 975,\n      \"rate\": 7.5\n    },\n    \"shipping\": null,\n    \"total\": {\n      \"amount\": 13975,\n      \"currency\": \"NGN\"\n    },\n    \"payment\": {\n      \"method\": \"cash\",\n      \"status\": \"paid\",\n      \"paidAt\": \"2026-10-02T14:05:00.000Z\"\n    },\n    \"fulfillmentStatus\": \"fulfilled\",\n    \"refundStatus\": null,\n    \"staff\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"note\": \"\",\n    \"statusHistory\": [\n      {\n        \"status\": \"confirmed\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"by\": \"Jane Doe\",\n        \"note\": null\n      }\n    ],\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List refunds",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/refunds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "refunds"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "orderId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `pos.refund` or `pos.sales`.\n\nScope: `pos:read`.\n\n`GET /refunds` · operationId `refunds.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "refunds"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "orderId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e507\",\n      \"refundNumber\": \"REF-1002\",\n      \"orderId\": \"66f1c2a9e4b0a1b2c3d4e505\",\n      \"orderNumber\": \"ORD1790904240356987\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"status\": \"completed\",\n      \"method\": \"original\",\n      \"reason\": \"damaged\",\n      \"amount\": {\n        \"amount\": 6500,\n        \"currency\": \"NGN\"\n      },\n      \"items\": [\n        {\n          \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n          \"name\": \"Rice 5kg\",\n          \"quantity\": 1\n        }\n      ],\n      \"customer\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n        \"name\": \"Ada Obi\"\n      },\n      \"processedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a refund",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/refunds/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "refunds",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.refund` or `pos.sales`.\n\nScope: `pos:read`.\n\n`GET /refunds/{id}` · operationId `refunds.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/refunds/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "refunds",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e507\",\n    \"refundNumber\": \"REF-1002\",\n    \"orderId\": \"66f1c2a9e4b0a1b2c3d4e505\",\n    \"orderNumber\": \"ORD1790904240356987\",\n    \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n    \"status\": \"completed\",\n    \"method\": \"original\",\n    \"reason\": \"damaged\",\n    \"amount\": {\n      \"amount\": 6500,\n      \"currency\": \"NGN\"\n    },\n    \"items\": [\n      {\n        \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n        \"name\": \"Rice 5kg\",\n        \"quantity\": 1\n      }\n    ],\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\"\n    },\n    \"processedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Customers",
      "description": "CRM customers, with loyalty balances. Reading needs crm.customers (or pos.pos, for looking up customers at the till); changes need crm.addcustomer. API keys need the `crm` scope.",
      "item": [
        {
          "name": "List customers",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "email",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "phone",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "membershipTier",
                  "value": "",
                  "description": "One of: Bronze, Silver, Gold.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `crm.customers` or `crm.addcustomer` or `crm.support` or `pos.pos`.\n\nScope: `crm:read`.\n\n`GET /customers` · operationId `customers.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "email",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "phone",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "membershipTier",
                      "value": "",
                      "description": "One of: Bronze, Silver, Gold.",
                      "disabled": true
                    },
                    {
                      "key": "active",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"customerCode\": \"C-1001\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\",\n      \"phone\": \"08098765432\",\n      \"address\": \"4 Allen Avenue, Ikeja\",\n      \"taxId\": \"\",\n      \"membershipTier\": \"Silver\",\n      \"loyaltyPoints\": 320,\n      \"loyaltyLifetimePoints\": 1450,\n      \"balance\": 0,\n      \"minimumOrder\": 0,\n      \"active\": true,\n      \"reps\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\"\n        }\n      ],\n      \"createdBy\": \"Jane Doe\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Create a customer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers"
              ]
            },
            "description": "Email, phone and customer code must be unique. A welcome email is sent when that setting is on.\n\nPermission: `crm.addcustomer`.\n\nScope: `crm:write`.\n\n`POST /customers` · operationId `customers.create`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"membershipTier\": \"Bronze\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"membershipTier\": \"Bronze\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n    \"customerCode\": \"C-1001\",\n    \"name\": \"Ada Obi\",\n    \"email\": \"ada@example.com\",\n    \"phone\": \"08098765432\",\n    \"address\": \"4 Allen Avenue, Ikeja\",\n    \"taxId\": \"\",\n    \"membershipTier\": \"Silver\",\n    \"loyaltyPoints\": 320,\n    \"loyaltyLifetimePoints\": 1450,\n    \"balance\": 0,\n    \"minimumOrder\": 0,\n    \"active\": true,\n    \"reps\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      }\n    ],\n    \"createdBy\": \"Jane Doe\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Get a customer",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `crm.customers` or `crm.addcustomer` or `crm.support` or `pos.pos`.\n\nScope: `crm:read`.\n\n`GET /customers/{id}` · operationId `customers.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n    \"customerCode\": \"C-1001\",\n    \"name\": \"Ada Obi\",\n    \"email\": \"ada@example.com\",\n    \"phone\": \"08098765432\",\n    \"address\": \"4 Allen Avenue, Ikeja\",\n    \"taxId\": \"\",\n    \"membershipTier\": \"Silver\",\n    \"loyaltyPoints\": 320,\n    \"loyaltyLifetimePoints\": 1450,\n    \"balance\": 0,\n    \"minimumOrder\": 0,\n    \"active\": true,\n    \"reps\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      }\n    ],\n    \"createdBy\": \"Jane Doe\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Update a customer",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Send only the fields to change.\n\nPermission: `crm.addcustomer`.\n\nScope: `crm:write`.\n\n`PATCH /customers/{id}` · operationId `customers.update`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"membershipTier\": \"Bronze\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"membershipTier\": \"Bronze\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n    \"customerCode\": \"C-1001\",\n    \"name\": \"Ada Obi\",\n    \"email\": \"ada@example.com\",\n    \"phone\": \"08098765432\",\n    \"address\": \"4 Allen Avenue, Ikeja\",\n    \"taxId\": \"\",\n    \"membershipTier\": \"Silver\",\n    \"loyaltyPoints\": 320,\n    \"loyaltyLifetimePoints\": 1450,\n    \"balance\": 0,\n    \"minimumOrder\": 0,\n    \"active\": true,\n    \"reps\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      }\n    ],\n    \"createdBy\": \"Jane Doe\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Loyalty balance and history",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id/loyalty",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id",
                "loyalty"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "One of: earn, redeem, reverse, restore, adjust, expire.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `crm.loyalty` or `crm.customers` or `pos.pos`.\n\nScope: `crm:read`.\n\n`GET /customers/{id}/loyalty` · operationId `customers.loyalty`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers/:id/loyalty",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers",
                    ":id",
                    "loyalty"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "type",
                      "value": "",
                      "description": "One of: earn, redeem, reverse, restore, adjust, expire.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"summary\": {\n      \"customerId\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"enabled\": true,\n      \"balance\": 459,\n      \"lifetime\": 1589,\n      \"value\": 45.9,\n      \"tier\": \"Silver\",\n      \"tierName\": \"Silver\",\n      \"nextTier\": {\n        \"key\": \"gold\",\n        \"name\": \"Gold\",\n        \"pointsNeeded\": 3411\n      },\n      \"redemption\": {\n        \"points\": 100,\n        \"value\": 10\n      },\n      \"redeemablePoints\": 400,\n      \"pointsPerAmount\": 1,\n      \"expiryMonths\": 12\n    },\n    \"history\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e508\",\n        \"type\": \"earn\",\n        \"points\": 139,\n        \"balanceAfter\": 459,\n        \"orderId\": \"66f1c2a9e4b0a1b2c3d4e505\",\n        \"orderNumber\": \"ORD1790904240356987\",\n        \"amount\": 13975,\n        \"description\": \"Earned on order ORD1790904240356987\",\n        \"source\": \"pos\",\n        \"by\": \"Jane Doe\",\n        \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n        \"expiresAt\": null\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Adjust loyalty points",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id/loyalty/adjustments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id",
                "loyalty",
                "adjustments"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Adds (positive) or removes (negative) points with a reason; recorded in the loyalty ledger. A balance cannot go below zero (409).\n\nPermission: `crm.loyaltyadjust`.\n\nScope: `crm:write`.\n\n`POST /customers/{id}/loyalty/adjustments` · operationId `customers.loyalty.adjust`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"points\": -1000000,\n  \"reason\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/customers/:id/loyalty/adjustments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "customers",
                    ":id",
                    "loyalty",
                    "adjustments"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"points\": -1000000,\n  \"reason\": \"\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"summary\": {\n      \"customerId\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"enabled\": true,\n      \"balance\": 459,\n      \"lifetime\": 1589,\n      \"value\": 45.9,\n      \"tier\": \"Silver\",\n      \"tierName\": \"Silver\",\n      \"nextTier\": {\n        \"key\": \"gold\",\n        \"name\": \"Gold\",\n        \"pointsNeeded\": 3411\n      },\n      \"redemption\": {\n        \"points\": 100,\n        \"value\": 10\n      },\n      \"redeemablePoints\": 400,\n      \"pointsPerAmount\": 1,\n      \"expiryMonths\": 12\n    },\n    \"entry\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e508\",\n      \"type\": \"adjust\",\n      \"points\": 50,\n      \"balanceAfter\": 509,\n      \"orderId\": null,\n      \"orderNumber\": null,\n      \"amount\": 0,\n      \"description\": \"Goodwill for late delivery\",\n      \"source\": \"api\",\n      \"by\": \"Jane Doe\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"expiresAt\": null\n    }\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "CRM",
      "description": "Leads (crm.leads), support tickets (crm.view), the loyalty report (crm.loyalty) and a customer timeline. API keys need the `crm` scope.",
      "item": [
        {
          "name": "List leads",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/leads",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "leads"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Closed, Not Contacted, Contacted, Lost, Open.",
                  "disabled": true
                },
                {
                  "key": "priority",
                  "value": "",
                  "description": "One of: Low, Medium, High, Urgent.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `crm.leads`.\n\nScope: `crm:read`.\n\n`GET /crm/leads` · operationId `crm.leads.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/leads",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "leads"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Closed, Not Contacted, Contacted, Lost, Open.",
                      "disabled": true
                    },
                    {
                      "key": "priority",
                      "value": "",
                      "description": "One of: Low, Medium, High, Urgent.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e509\",\n      \"name\": \"Bola Ade\",\n      \"company\": \"Ade Foods Ltd\",\n      \"email\": \"bola@adefoods.example\",\n      \"phone\": \"08031112222\",\n      \"status\": \"Contacted\",\n      \"priority\": \"High\",\n      \"source\": \"website\",\n      \"type\": \"wholesale\",\n      \"industry\": \"Retail\",\n      \"country\": \"Nigeria\",\n      \"state\": \"Lagos\",\n      \"expectedIncome\": 2500000,\n      \"currency\": \"NGN\",\n      \"probability\": 60,\n      \"owner\": \"Jane Doe\",\n      \"dueDate\": \"2026-10-15T00:00:00.000Z\",\n      \"lastContactedAt\": \"2026-10-01T09:30:00.000Z\",\n      \"nextFollowUpAt\": \"2026-10-05T10:00:00.000Z\",\n      \"closedAt\": null,\n      \"tags\": [\n        \"bulk\"\n      ],\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a lead (with recent activity)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/leads/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "leads",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `crm.leads`.\n\nScope: `crm:read`.\n\n`GET /crm/leads/{id}` · operationId `crm.leads.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/leads/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "leads",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e509\",\n    \"name\": \"Bola Ade\",\n    \"company\": \"Ade Foods Ltd\",\n    \"email\": \"bola@adefoods.example\",\n    \"phone\": \"08031112222\",\n    \"status\": \"Contacted\",\n    \"priority\": \"High\",\n    \"source\": \"website\",\n    \"type\": \"wholesale\",\n    \"industry\": \"Retail\",\n    \"country\": \"Nigeria\",\n    \"state\": \"Lagos\",\n    \"expectedIncome\": 2500000,\n    \"currency\": \"NGN\",\n    \"probability\": 60,\n    \"owner\": \"Jane Doe\",\n    \"dueDate\": \"2026-10-15T00:00:00.000Z\",\n    \"lastContactedAt\": \"2026-10-01T09:30:00.000Z\",\n    \"nextFollowUpAt\": \"2026-10-05T10:00:00.000Z\",\n    \"closedAt\": null,\n    \"tags\": [\n      \"bulk\"\n    ],\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"description\": \"Wants monthly supply of rice and oil.\",\n    \"website\": \"https://adefoods.example\",\n    \"activities\": [\n      {\n        \"type\": \"call\",\n        \"text\": \"Discussed pricing\",\n        \"by\": \"Jane Doe\",\n        \"at\": \"2026-10-01T09:30:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "List support tickets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/tickets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "tickets"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: open, answered, closed.",
                  "disabled": true
                },
                {
                  "key": "customerId",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `crm.view` or `crm.support`.\n\nScope: `crm:read`.\n\n`GET /crm/tickets` · operationId `crm.tickets.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/tickets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "tickets"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: open, answered, closed.",
                      "disabled": true
                    },
                    {
                      "key": "customerId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e510\",\n      \"ticketNumber\": \"TCK-2041\",\n      \"title\": \"Wrong item delivered\",\n      \"category\": \"Delivery\",\n      \"status\": \"answered\",\n      \"customer\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n        \"name\": \"Ada Obi\",\n        \"email\": \"ada@example.com\"\n      },\n      \"assignedTo\": \"Jane Doe\",\n      \"tag\": \"urgent\",\n      \"message\": \"I received beans instead of rice.\",\n      \"createdBy\": \"Jane Doe\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a support ticket",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/tickets/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "tickets",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `crm.view` or `crm.support`.\n\nScope: `crm:read`.\n\n`GET /crm/tickets/{id}` · operationId `crm.tickets.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/tickets/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "tickets",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e510\",\n    \"ticketNumber\": \"TCK-2041\",\n    \"title\": \"Wrong item delivered\",\n    \"category\": \"Delivery\",\n    \"status\": \"answered\",\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\",\n      \"email\": \"ada@example.com\"\n    },\n    \"assignedTo\": \"Jane Doe\",\n    \"tag\": \"urgent\",\n    \"message\": \"I received beans instead of rice.\",\n    \"createdBy\": \"Jane Doe\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Loyalty programme report",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/loyalty/report",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "loyalty",
                "report"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                }
              ]
            },
            "description": "Points issued, redeemed and outstanding, top earners and customers per tier for a period.\n\nPermission: `crm.loyalty`.\n\nScope: `crm:read`.\n\n`GET /crm/loyalty/report` · operationId `crm.loyalty.report`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/loyalty/report",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "loyalty",
                    "report"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"period\": {\n      \"from\": \"2026-09-01T00:00:00.000Z\",\n      \"to\": \"2026-09-30T23:59:59.999Z\"\n    },\n    \"enabled\": true,\n    \"totals\": {\n      \"earn\": {\n        \"points\": 18450,\n        \"count\": 212,\n        \"amount\": 1845000\n      },\n      \"redeem\": {\n        \"points\": -4200,\n        \"count\": 31,\n        \"amount\": 420\n      },\n      \"reverse\": {\n        \"points\": -300,\n        \"count\": 2,\n        \"amount\": 30000\n      },\n      \"restore\": {\n        \"points\": 100,\n        \"count\": 1,\n        \"amount\": 10\n      },\n      \"adjust\": {\n        \"points\": 250,\n        \"count\": 3,\n        \"amount\": 0\n      },\n      \"expire\": {\n        \"points\": -120,\n        \"count\": 4,\n        \"amount\": 0\n      }\n    },\n    \"pointsIssued\": 18700,\n    \"pointsRedeemed\": 4200,\n    \"redeemedValue\": 420,\n    \"outstandingPoints\": 52310,\n    \"outstandingCustomers\": 418,\n    \"outstandingValue\": 5231,\n    \"topEarners\": [\n      {\n        \"customerId\": \"66f1c2a9e4b0a1b2c3d4e506\",\n        \"name\": \"Ada Obi\",\n        \"points\": 1390,\n        \"orders\": 9\n      }\n    ],\n    \"tiers\": [\n      {\n        \"tier\": \"Bronze\",\n        \"customers\": 301\n      },\n      {\n        \"tier\": \"Silver\",\n        \"customers\": 96\n      },\n      {\n        \"tier\": \"Gold\",\n        \"customers\": 21\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Customer timeline",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/customers/:id/activity",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "customers",
                ":id",
                "activity"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "20",
                  "description": "",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Latest orders, loyalty entries and support tickets for one customer, newest first.\n\nPermission: `crm.customers` or `crm.support` or `crm.loyalty`.\n\nScope: `crm:read`.\n\n`GET /crm/customers/{id}/activity` · operationId `crm.customers.activity`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/crm/customers/:id/activity",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "crm",
                    "customers",
                    ":id",
                    "activity"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "20",
                      "description": "",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"customer\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e506\",\n      \"name\": \"Ada Obi\"\n    },\n    \"events\": [\n      {\n        \"type\": \"loyalty\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e508\",\n        \"title\": \"Earned 139 points\",\n        \"detail\": \"Earned on order ORD1790904240356987\",\n        \"balanceAfter\": 459\n      },\n      {\n        \"type\": \"order\",\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n        \"title\": \"Order ORD1790904240356987\",\n        \"detail\": \"confirmed, paid by cash\",\n        \"amount\": 13975,\n        \"store\": \"Main Street\"\n      }\n    ]\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "HR",
      "description": "Employees (hr.employees), attendance (hr.attendance), leave (hr.leaves) and payroll (hr.payroll). Read only. API keys need the `hr` scope.",
      "item": [
        {
          "name": "List employees",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/employees",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "employees"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "department",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "designation",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `hr.employees`.\n\nScope: `hr:read`.\n\n`GET /hr/employees` · operationId `hr.employees.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/employees",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "employees"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "department",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "designation",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "active",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e511\",\n      \"employeeNumber\": \"E-014\",\n      \"name\": \"Emma Obi\",\n      \"email\": \"emma@example.com\",\n      \"mobile\": \"08055556666\",\n      \"department\": \"Sales\",\n      \"designation\": \"Cashier\",\n      \"role\": \"Staff\",\n      \"unit\": \"Front desk\",\n      \"location\": \"Main Street\",\n      \"employmentType\": \"Full time\",\n      \"gender\": \"Female\",\n      \"reportingTo\": \"Jane Doe\",\n      \"active\": true,\n      \"joinedOn\": \"2025-03-01\",\n      \"probationEndsOn\": \"2025-06-01\",\n      \"contractEndsOn\": null,\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get an employee",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/employees/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "employees",
                ":id"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Includes salary, bank and pension details only when you have hr.payroll.\n\nPermission: `hr.employees`.\n\nScope: `hr:read`.\n\n`GET /hr/employees/{id}` · operationId `hr.employees.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/employees/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "employees",
                    ":id"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e511\",\n    \"employeeNumber\": \"E-014\",\n    \"name\": \"Emma Obi\",\n    \"email\": \"emma@example.com\",\n    \"mobile\": \"08055556666\",\n    \"department\": \"Sales\",\n    \"designation\": \"Cashier\",\n    \"role\": \"Staff\",\n    \"unit\": \"Front desk\",\n    \"location\": \"Main Street\",\n    \"employmentType\": \"Full time\",\n    \"gender\": \"Female\",\n    \"reportingTo\": \"Jane Doe\",\n    \"active\": true,\n    \"joinedOn\": \"2025-03-01\",\n    \"probationEndsOn\": \"2025-06-01\",\n    \"contractEndsOn\": null,\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"address\": \"7 Broad Street\",\n    \"country\": \"Nigeria\",\n    \"state\": \"Lagos\",\n    \"language\": \"English\",\n    \"salutation\": \"Ms\",\n    \"maritalStatus\": \"Single\",\n    \"skills\": \"Customer service\",\n    \"note\": \"\",\n    \"salary\": {\n      \"level\": 3,\n      \"gross\": 250000,\n      \"basic\": 180000,\n      \"allowance\": 50000,\n      \"other\": 20000,\n      \"cycle\": \"monthly\"\n    },\n    \"bank\": {\n      \"name\": \"First Bank\",\n      \"accountNumber\": \"0123456789\"\n    },\n    \"pension\": {\n      \"administrator\": \"Stanbic IBTC Pension\",\n      \"number\": \"PEN100200300\"\n    },\n    \"taxNumber\": \"12345678-0001\",\n    \"nhfNumber\": \"NHF-55001\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Departments and head count",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/departments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "departments"
              ]
            },
            "description": "Departments set up in HR settings plus any used on employee records, with the number of employees in each.\n\nPermission: `hr.employees`.\n\nScope: `hr:read`.\n\n`GET /hr/departments` · operationId `hr.departments`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/departments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "departments"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"name\": \"Operations\",\n      \"employees\": 4\n    },\n    {\n      \"name\": \"Sales\",\n      \"employees\": 9\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Attendance records",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/attendance",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "attendance"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "employeeId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "late",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `hr.attendance`.\n\nScope: `hr:read`.\n\n`GET /hr/attendance` · operationId `hr.attendance.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/attendance",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "attendance"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "employeeId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "late",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e512\",\n      \"employeeId\": \"66f1c2a9e4b0a1b2c3d4e511\",\n      \"employeeNumber\": \"E-014\",\n      \"name\": \"Emma Obi\",\n      \"role\": \"Cashier\",\n      \"clockIn\": \"2026-10-02T07:58:00.000Z\",\n      \"clockOut\": \"2026-10-02T17:02:00.000Z\",\n      \"late\": false,\n      \"location\": \"Main Street\",\n      \"workday\": \"2026-10-02\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Leave requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/leaves",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "leaves"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "employeeId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `hr.leaves`.\n\nScope: `hr:read`.\n\n`GET /hr/leaves` · operationId `hr.leaves.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/leaves",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "leaves"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "employeeId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e513\",\n      \"employeeId\": \"66f1c2a9e4b0a1b2c3d4e511\",\n      \"employeeNumber\": \"E-014\",\n      \"name\": \"Emma Obi\",\n      \"type\": \"Annual leave\",\n      \"status\": \"1\",\n      \"startDate\": \"2026-11-03\",\n      \"endDate\": \"2026-11-07\",\n      \"duration\": 5,\n      \"paid\": true,\n      \"note\": \"Family trip\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Payroll records (payslips)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/payroll",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "payroll"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "employeeId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "department",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `hr.payroll`.\n\nScope: `hr:read`.\n\n`GET /hr/payroll` · operationId `hr.payroll.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/payroll",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "payroll"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "employeeId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "department",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e514\",\n      \"employeeId\": \"66f1c2a9e4b0a1b2c3d4e511\",\n      \"employeeNumber\": \"E-014\",\n      \"name\": \"Emma Obi\",\n      \"designation\": \"Cashier\",\n      \"department\": \"Sales\",\n      \"payDate\": \"2026-09-30T00:00:00.000Z\",\n      \"payType\": \"month\",\n      \"basic\": 180000,\n      \"allowance\": 50000,\n      \"other\": 20000,\n      \"gross\": 250000,\n      \"net\": 221500,\n      \"deductions\": {\n        \"tax\": 18500,\n        \"pension\": 10000\n      },\n      \"attendanceDays\": 21,\n      \"totalDays\": 22,\n      \"unpaidLeaveDays\": 0,\n      \"latenessCount\": 1,\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a payroll record",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/hr/payroll/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "hr",
                "payroll",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `hr.payroll`.\n\nScope: `hr:read`.\n\n`GET /hr/payroll/{id}` · operationId `hr.payroll.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/hr/payroll/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "hr",
                    "payroll",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e514\",\n    \"employeeId\": \"66f1c2a9e4b0a1b2c3d4e511\",\n    \"employeeNumber\": \"E-014\",\n    \"name\": \"Emma Obi\",\n    \"designation\": \"Cashier\",\n    \"department\": \"Sales\",\n    \"payDate\": \"2026-09-30T00:00:00.000Z\",\n    \"payType\": \"month\",\n    \"basic\": 180000,\n    \"allowance\": 50000,\n    \"other\": 20000,\n    \"gross\": 250000,\n    \"net\": 221500,\n    \"deductions\": {\n      \"tax\": 18500,\n      \"pension\": 10000\n    },\n    \"attendanceDays\": 21,\n    \"totalDays\": 22,\n    \"unpaidLeaveDays\": 0,\n    \"latenessCount\": 1,\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Finance",
      "description": "Read-only access to the Finance module. Each list needs the matching Finance permission (e.g. financial.finexpenses). API keys need the `finance` scope.",
      "item": [
        {
          "name": "List income entries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/income",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "income"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Received, Pending, Cancelled.",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finincome`.\n\nScope: `finance:read`.\n\n`GET /finance/income` · operationId `finance.income.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/income",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "income"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Received, Pending, Cancelled.",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e520\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"INC-0042\",\n      \"date\": \"2026-10-02T14:05:00.000Z\",\n      \"reference\": \"POS-SALES-0210\",\n      \"description\": \"Daily POS sales\",\n      \"category\": \"Sales\",\n      \"source\": \"POS\",\n      \"amount\": 845000,\n      \"paymentMethod\": \"Cash\",\n      \"status\": \"Received\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the income entries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/income/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "income",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finincome`.\n\nScope: `finance:read`.\n\n`GET /finance/income/{id}` · operationId `finance.income.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/income/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "income",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e520\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"INC-0042\",\n    \"date\": \"2026-10-02T14:05:00.000Z\",\n    \"reference\": \"POS-SALES-0210\",\n    \"description\": \"Daily POS sales\",\n    \"category\": \"Sales\",\n    \"source\": \"POS\",\n    \"amount\": 845000,\n    \"paymentMethod\": \"Cash\",\n    \"status\": \"Received\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List expenses",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/expenses",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "expenses"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Paid, Unpaid, Partially Paid, Cancelled.",
                  "disabled": true
                },
                {
                  "key": "vendorId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finexpenses`.\n\nScope: `finance:read`.\n\n`GET /finance/expenses` · operationId `finance.expenses.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/expenses",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "expenses"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Paid, Unpaid, Partially Paid, Cancelled.",
                      "disabled": true
                    },
                    {
                      "key": "vendorId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e521\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"EXP-0108\",\n      \"date\": \"2026-10-02T14:05:00.000Z\",\n      \"dueDate\": \"2026-10-16T00:00:00.000Z\",\n      \"reference\": \"INV-7781\",\n      \"description\": \"Generator diesel\",\n      \"category\": \"Utilities\",\n      \"vendor\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n        \"name\": \"Total Energies\"\n      },\n      \"amount\": 120000,\n      \"paymentMethod\": \"Bank transfer\",\n      \"status\": \"Paid\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the expenses",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/expenses/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "expenses",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finexpenses`.\n\nScope: `finance:read`.\n\n`GET /finance/expenses/{id}` · operationId `finance.expenses.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/expenses/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "expenses",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e521\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"EXP-0108\",\n    \"date\": \"2026-10-02T14:05:00.000Z\",\n    \"dueDate\": \"2026-10-16T00:00:00.000Z\",\n    \"reference\": \"INV-7781\",\n    \"description\": \"Generator diesel\",\n    \"category\": \"Utilities\",\n    \"vendor\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n      \"name\": \"Total Energies\"\n    },\n    \"amount\": 120000,\n    \"paymentMethod\": \"Bank transfer\",\n    \"status\": \"Paid\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List vendors",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/vendors",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "vendors"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Active, Inactive.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finvendors`.\n\nScope: `finance:read`.\n\n`GET /finance/vendors` · operationId `finance.vendors.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/vendors",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "vendors"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Active, Inactive.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"VEN-0007\",\n      \"code\": \"TOTAL\",\n      \"name\": \"Total Energies\",\n      \"company\": \"Total Energies Marketing Nigeria\",\n      \"email\": \"sales@total.example\",\n      \"phone\": \"01-2700000\",\n      \"address\": \"4 Adeola Odeku\",\n      \"city\": \"Lagos\",\n      \"state\": \"Lagos\",\n      \"contactPerson\": \"Musa Bello\",\n      \"openingBalance\": 0,\n      \"creditLimit\": 1000000,\n      \"paymentTerms\": \"Net 30\",\n      \"status\": \"Active\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the vendors",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/vendors/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "vendors",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finvendors`.\n\nScope: `finance:read`.\n\n`GET /finance/vendors/{id}` · operationId `finance.vendors.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/vendors/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "vendors",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"VEN-0007\",\n    \"code\": \"TOTAL\",\n    \"name\": \"Total Energies\",\n    \"company\": \"Total Energies Marketing Nigeria\",\n    \"email\": \"sales@total.example\",\n    \"phone\": \"01-2700000\",\n    \"address\": \"4 Adeola Odeku\",\n    \"city\": \"Lagos\",\n    \"state\": \"Lagos\",\n    \"contactPerson\": \"Musa Bello\",\n    \"openingBalance\": 0,\n    \"creditLimit\": 1000000,\n    \"paymentTerms\": \"Net 30\",\n    \"status\": \"Active\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List payables (bills to pay)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/payables",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "payables"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Unpaid, Partially Paid, Paid, Overdue.",
                  "disabled": true
                },
                {
                  "key": "vendorId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finpayables`.\n\nScope: `finance:read`.\n\n`GET /finance/payables` · operationId `finance.payables.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/payables",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "payables"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Unpaid, Partially Paid, Paid, Overdue.",
                      "disabled": true
                    },
                    {
                      "key": "vendorId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e523\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"PAY-0031\",\n      \"date\": \"2026-10-01T09:30:00.000Z\",\n      \"dueDate\": \"2026-10-31T00:00:00.000Z\",\n      \"reference\": \"INV-7790\",\n      \"description\": \"Rice supply (200 bags)\",\n      \"vendor\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n        \"name\": \"Total Energies\"\n      },\n      \"amount\": 1040000,\n      \"paid\": 500000,\n      \"balance\": 540000,\n      \"status\": \"Partially Paid\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the payables (bills to pay)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/payables/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "payables",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finpayables`.\n\nScope: `finance:read`.\n\n`GET /finance/payables/{id}` · operationId `finance.payables.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/payables/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "payables",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e523\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"PAY-0031\",\n    \"date\": \"2026-10-01T09:30:00.000Z\",\n    \"dueDate\": \"2026-10-31T00:00:00.000Z\",\n    \"reference\": \"INV-7790\",\n    \"description\": \"Rice supply (200 bags)\",\n    \"vendor\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n      \"name\": \"Total Energies\"\n    },\n    \"amount\": 1040000,\n    \"paid\": 500000,\n    \"balance\": 540000,\n    \"status\": \"Partially Paid\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List receivables (money owed to you)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/receivables",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "receivables"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Outstanding, Partially Received, Received, Overdue.",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finreceivables`.\n\nScope: `finance:read`.\n\n`GET /finance/receivables` · operationId `finance.receivables.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/receivables",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "receivables"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Outstanding, Partially Received, Received, Overdue.",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e524\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"REC-0012\",\n      \"date\": \"2026-10-01T09:30:00.000Z\",\n      \"dueDate\": \"2026-10-20T00:00:00.000Z\",\n      \"reference\": \"WHL-0009\",\n      \"description\": \"Wholesale order for Ade Foods\",\n      \"source\": \"Wholesale\",\n      \"amount\": 650000,\n      \"received\": 300000,\n      \"balance\": 350000,\n      \"status\": \"Partially Received\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the receivables (money owed to you)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/receivables/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "receivables",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finreceivables`.\n\nScope: `finance:read`.\n\n`GET /finance/receivables/{id}` · operationId `finance.receivables.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/receivables/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "receivables",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e524\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"REC-0012\",\n    \"date\": \"2026-10-01T09:30:00.000Z\",\n    \"dueDate\": \"2026-10-20T00:00:00.000Z\",\n    \"reference\": \"WHL-0009\",\n    \"description\": \"Wholesale order for Ade Foods\",\n    \"source\": \"Wholesale\",\n    \"amount\": 650000,\n    \"received\": 300000,\n    \"balance\": 350000,\n    \"status\": \"Partially Received\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List payments to vendors",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/vendor-payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "vendor-payments"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "vendorId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finpayments`.\n\nScope: `finance:read`.\n\n`GET /finance/vendor-payments` · operationId `finance.vendor-payments.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/vendor-payments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "vendor-payments"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "vendorId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e525\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"VP-0019\",\n      \"date\": \"2026-10-02T14:05:00.000Z\",\n      \"reference\": \"TRF-55120\",\n      \"vendor\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n        \"name\": \"Total Energies\"\n      },\n      \"amount\": 500000,\n      \"paymentMethod\": \"Bank transfer\",\n      \"description\": \"Part payment for INV-7790\",\n      \"payableId\": \"66f1c2a9e4b0a1b2c3d4e523\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the payments to vendors",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/vendor-payments/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "vendor-payments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finpayments`.\n\nScope: `finance:read`.\n\n`GET /finance/vendor-payments/{id}` · operationId `finance.vendor-payments.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/vendor-payments/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "vendor-payments",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e525\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"VP-0019\",\n    \"date\": \"2026-10-02T14:05:00.000Z\",\n    \"reference\": \"TRF-55120\",\n    \"vendor\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n      \"name\": \"Total Energies\"\n    },\n    \"amount\": 500000,\n    \"paymentMethod\": \"Bank transfer\",\n    \"description\": \"Part payment for INV-7790\",\n    \"payableId\": \"66f1c2a9e4b0a1b2c3d4e523\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List payments received",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/receivable-payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "receivable-payments"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finpayments`.\n\nScope: `finance:read`.\n\n`GET /finance/receivable-payments` · operationId `finance.receivable-payments.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/receivable-payments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "receivable-payments"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e526\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"RP-0008\",\n      \"date\": \"2026-10-02T14:05:00.000Z\",\n      \"reference\": \"TRF-88101\",\n      \"receivableId\": \"66f1c2a9e4b0a1b2c3d4e524\",\n      \"amount\": 300000,\n      \"paymentMethod\": \"Bank transfer\",\n      \"description\": \"Ade Foods part payment\",\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the payments received",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/receivable-payments/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "receivable-payments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finpayments`.\n\nScope: `finance:read`.\n\n`GET /finance/receivable-payments/{id}` · operationId `finance.receivable-payments.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/receivable-payments/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "receivable-payments",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e526\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"RP-0008\",\n    \"date\": \"2026-10-02T14:05:00.000Z\",\n    \"reference\": \"TRF-88101\",\n    \"receivableId\": \"66f1c2a9e4b0a1b2c3d4e524\",\n    \"amount\": 300000,\n    \"paymentMethod\": \"Bank transfer\",\n    \"description\": \"Ade Foods part payment\",\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List ledger transactions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/transactions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "transactions"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "One of: Income, Expense, Vendor Payment, Receivable, Receivable Payment, Payable, Adjustment.",
                  "disabled": true
                },
                {
                  "key": "vendorId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.fintransactions`.\n\nScope: `finance:read`.\n\n`GET /finance/transactions` · operationId `finance.transactions.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/transactions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "type",
                      "value": "",
                      "description": "One of: Income, Expense, Vendor Payment, Receivable, Receivable Payment, Payable, Adjustment.",
                      "disabled": true
                    },
                    {
                      "key": "vendorId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e527\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"TXN-1201\",\n      \"date\": \"2026-10-02T14:05:00.000Z\",\n      \"reference\": \"EXP-0108\",\n      \"type\": \"Expense\",\n      \"description\": \"Generator diesel\",\n      \"category\": \"Utilities\",\n      \"vendor\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n        \"name\": \"Total Energies\"\n      },\n      \"debit\": 120000,\n      \"credit\": 0,\n      \"amount\": 120000,\n      \"balance\": 3240000,\n      \"paymentMethod\": \"Bank transfer\",\n      \"status\": \"Posted\",\n      \"sourceId\": \"66f1c2a9e4b0a1b2c3d4e521\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the ledger transactions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/transactions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "transactions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.fintransactions`.\n\nScope: `finance:read`.\n\n`GET /finance/transactions/{id}` · operationId `finance.transactions.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/transactions/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "transactions",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e527\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"TXN-1201\",\n    \"date\": \"2026-10-02T14:05:00.000Z\",\n    \"reference\": \"EXP-0108\",\n    \"type\": \"Expense\",\n    \"description\": \"Generator diesel\",\n    \"category\": \"Utilities\",\n    \"vendor\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e522\",\n      \"name\": \"Total Energies\"\n    },\n    \"debit\": 120000,\n    \"credit\": 0,\n    \"amount\": 120000,\n    \"balance\": 3240000,\n    \"paymentMethod\": \"Bank transfer\",\n    \"status\": \"Posted\",\n    \"sourceId\": \"66f1c2a9e4b0a1b2c3d4e521\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List budgets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/budgets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "budgets"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.finbudgets`.\n\nScope: `finance:read`.\n\n`GET /finance/budgets` · operationId `finance.budgets.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/budgets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "budgets"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e528\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"BUD-2026-Q4\",\n      \"name\": \"Q4 utilities\",\n      \"category\": \"Utilities\",\n      \"period\": \"quarterly\",\n      \"startDate\": \"2026-10-01T00:00:00.000Z\",\n      \"endDate\": \"2026-12-31T00:00:00.000Z\",\n      \"amount\": 600000,\n      \"notes\": \"\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the budgets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/budgets/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "budgets",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.finbudgets`.\n\nScope: `finance:read`.\n\n`GET /finance/budgets/{id}` · operationId `finance.budgets.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/budgets/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "budgets",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e528\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"BUD-2026-Q4\",\n    \"name\": \"Q4 utilities\",\n    \"category\": \"Utilities\",\n    \"period\": \"quarterly\",\n    \"startDate\": \"2026-10-01T00:00:00.000Z\",\n    \"endDate\": \"2026-12-31T00:00:00.000Z\",\n    \"amount\": 600000,\n    \"notes\": \"\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/categories",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "categories"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: Active, Inactive.",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "One of: Income, Expense.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `financial.fincategories`.\n\nScope: `finance:read`.\n\n`GET /finance/categories` · operationId `finance.categories.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/categories",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "categories"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: Active, Inactive.",
                      "disabled": true
                    },
                    {
                      "key": "type",
                      "value": "",
                      "description": "One of: Income, Expense.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e529\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n      \"number\": \"CAT-0004\",\n      \"name\": \"Utilities\",\n      \"type\": \"Expense\",\n      \"description\": \"Power, water, internet\",\n      \"status\": \"Active\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get one of the categories",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/categories/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "categories",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `financial.fincategories`.\n\nScope: `finance:read`.\n\n`GET /finance/categories/{id}` · operationId `finance.categories.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/categories/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "categories",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e529\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"number\": \"CAT-0004\",\n    \"name\": \"Utilities\",\n    \"type\": \"Expense\",\n    \"description\": \"Power, water, internet\",\n    \"status\": \"Active\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Income, expenses and balances for a period",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/finance/summary",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "finance",
                "summary"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                }
              ]
            },
            "description": "Totals of received income and non-cancelled expenses in the period (default: this month), plus what is still owed to and by you today.\n\nPermission: `financial.finreports` or `financial.findashboard`.\n\nScope: `finance:read`.\n\n`GET /finance/summary` · operationId `finance.summary`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/finance/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "finance",
                    "summary"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"period\": {\n      \"from\": \"2026-10-01\",\n      \"to\": \"2026-10-31\"\n    },\n    \"income\": {\n      \"total\": 1200000,\n      \"count\": 14\n    },\n    \"expenses\": {\n      \"total\": 830000,\n      \"count\": 22\n    },\n    \"net\": 370000,\n    \"payablesOutstanding\": {\n      \"total\": 150000,\n      \"count\": 3\n    },\n    \"receivablesOutstanding\": {\n      \"total\": 90000,\n      \"count\": 2\n    }\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Projects",
      "description": "Projects (project.project) and tasks (project.alltask), limited to the ones you take part in. API keys need the `projects` scope.",
      "item": [
        {
          "name": "List your projects",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/projects",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "projects"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: new, started, ongoing, in_review, completed.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `project.project`.\n\nScope: `projects:read`.\n\n`GET /projects` · operationId `projects.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/projects",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "projects"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: new, started, ongoing, in_review, completed.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e515\",\n      \"title\": \"Open the Ikeja branch\",\n      \"status\": \"ongoing\",\n      \"startsAt\": \"2026-09-01T00:00:00.000Z\",\n      \"endsAt\": \"2026-12-01T00:00:00.000Z\",\n      \"owner\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"members\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\",\n          \"email\": \"jane@example.com\"\n        }\n      ],\n      \"tasks\": {\n        \"total\": 12,\n        \"completed\": 5\n      },\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a project",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/projects/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "projects",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `project.project`.\n\nScope: `projects:read`.\n\n`GET /projects/{id}` · operationId `projects.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/projects/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "projects",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e515\",\n    \"title\": \"Open the Ikeja branch\",\n    \"status\": \"ongoing\",\n    \"startsAt\": \"2026-09-01T00:00:00.000Z\",\n    \"endsAt\": \"2026-12-01T00:00:00.000Z\",\n    \"owner\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"members\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\",\n        \"email\": \"jane@example.com\"\n      }\n    ],\n    \"tasks\": {\n      \"total\": 12,\n      \"completed\": 5,\n      \"byStatus\": {\n        \"new\": 2,\n        \"started\": 1,\n        \"ongoing\": 3,\n        \"in_review\": 1,\n        \"completed\": 5\n      }\n    },\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "List a project's tasks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/projects/:id/tasks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "projects",
                ":id",
                "tasks"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: new, started, ongoing, in_review, completed.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `project.project` or `project.alltask`.\n\nScope: `projects:read`.\n\n`GET /projects/{id}/tasks` · operationId `projects.tasks`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/projects/:id/tasks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "projects",
                    ":id",
                    "tasks"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: new, started, ongoing, in_review, completed.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e516\",\n      \"projectId\": \"66f1c2a9e4b0a1b2c3d4e515\",\n      \"title\": \"Order shelving\",\n      \"type\": \"task\",\n      \"status\": \"started\",\n      \"startDate\": \"2026-10-01T00:00:00.000Z\",\n      \"endDate\": \"2026-10-10T00:00:00.000Z\",\n      \"budget\": 450000,\n      \"owner\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"assignedTo\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\",\n          \"email\": \"jane@example.com\"\n        }\n      ],\n      \"members\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\",\n          \"email\": \"jane@example.com\"\n        }\n      ],\n      \"workflow\": \"Purchase approval\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "List your tasks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/tasks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tasks"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "",
                  "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "",
                  "description": "Comma-separated fields to return. Example: id,name,status",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: new, started, ongoing, in_review, completed.",
                  "disabled": true
                },
                {
                  "key": "projectId",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `project.alltask`.\n\nScope: `projects:read`.\n\n`GET /tasks` · operationId `tasks.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/tasks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "tasks"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "",
                      "description": "Comma-separated fields; prefix with - for descending. Example: -createdAt,name",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "",
                      "description": "Comma-separated fields to return. Example: id,name,status",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: new, started, ongoing, in_review, completed.",
                      "disabled": true
                    },
                    {
                      "key": "projectId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e516\",\n      \"projectId\": \"66f1c2a9e4b0a1b2c3d4e515\",\n      \"title\": \"Order shelving\",\n      \"type\": \"task\",\n      \"status\": \"started\",\n      \"startDate\": \"2026-10-01T00:00:00.000Z\",\n      \"endDate\": \"2026-10-10T00:00:00.000Z\",\n      \"budget\": 450000,\n      \"owner\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"assignedTo\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\",\n          \"email\": \"jane@example.com\"\n        }\n      ],\n      \"members\": [\n        {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n          \"name\": \"Jane Doe\",\n          \"email\": \"jane@example.com\"\n        }\n      ],\n      \"workflow\": \"Purchase approval\",\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n      \"updatedAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a task",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/tasks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tasks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `project.alltask` or `project.project`.\n\nScope: `projects:read`.\n\n`GET /tasks/{id}` · operationId `tasks.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/tasks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "tasks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"id\": \"66f1c2a9e4b0a1b2c3d4e516\",\n    \"projectId\": \"66f1c2a9e4b0a1b2c3d4e515\",\n    \"title\": \"Order shelving\",\n    \"type\": \"task\",\n    \"status\": \"started\",\n    \"startDate\": \"2026-10-01T00:00:00.000Z\",\n    \"endDate\": \"2026-10-10T00:00:00.000Z\",\n    \"budget\": 450000,\n    \"owner\": {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\"\n    },\n    \"assignedTo\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\",\n        \"email\": \"jane@example.com\"\n      }\n    ],\n    \"members\": [\n      {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\",\n        \"email\": \"jane@example.com\"\n      }\n    ],\n    \"workflow\": \"Purchase approval\",\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"updatedAt\": \"2026-10-02T14:05:00.000Z\",\n    \"description\": \"Get three quotes and order shelving for the new branch.\",\n    \"approvals\": [\n      {\n        \"title\": \"Manager approval\",\n        \"approved\": true,\n        \"by\": \"Jane Doe\",\n        \"at\": \"2026-10-02T14:05:00.000Z\"\n      }\n    ]\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Reports",
      "description": "Sales reports (pos.report or pos.sales). Cancelled and refunded orders are left out. Default period: the last 30 days. API keys need the `reports` scope.",
      "item": [
        {
          "name": "Sales summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/reports/sales",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reports",
                "sales"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                },
                {
                  "key": "groupBy",
                  "value": "day",
                  "description": "One of: day, week, month.",
                  "disabled": true
                }
              ]
            },
            "description": "Totals for the period plus a breakdown by day, week or month and by payment method.\n\nPermission: `pos.report` or `pos.sales`.\n\nScope: `reports:read`.\n\n`GET /reports/sales` · operationId `reports.sales`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/sales",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "sales"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    },
                    {
                      "key": "groupBy",
                      "value": "day",
                      "description": "One of: day, week, month.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"period\": {\n      \"from\": \"2026-09-01T00:00:00.000Z\",\n      \"to\": \"2026-09-30T23:59:59.999Z\"\n    },\n    \"totals\": {\n      \"orders\": 412,\n      \"revenue\": 5384000,\n      \"tax\": 375600,\n      \"discounts\": 21000,\n      \"averageOrder\": 13067.96,\n      \"itemsSold\": 1530\n    },\n    \"series\": [\n      {\n        \"period\": \"2026-09-01\",\n        \"orders\": 14,\n        \"revenue\": 182500\n      },\n      {\n        \"period\": \"2026-09-02\",\n        \"orders\": 11,\n        \"revenue\": 151200\n      }\n    ],\n    \"byPaymentMethod\": [\n      {\n        \"method\": \"cash\",\n        \"orders\": 260,\n        \"revenue\": 3105000\n      },\n      {\n        \"method\": \"transfer\",\n        \"orders\": 152,\n        \"revenue\": 2279000\n      }\n    ],\n    \"byStatus\": [\n      {\n        \"status\": \"completed\",\n        \"orders\": 398\n      },\n      {\n        \"status\": \"cancelled\",\n        \"orders\": 14\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Best-selling products",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/reports/top-products",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reports",
                "top-products"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "10",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "by",
                  "value": "revenue",
                  "description": "One of: revenue, quantity.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `pos.report` or `pos.sales`.\n\nScope: `reports:read`.\n\n`GET /reports/top-products` · operationId `reports.products`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/top-products",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "top-products"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "10",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "by",
                      "value": "revenue",
                      "description": "One of: revenue, quantity.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"productId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n      \"name\": \"Rice 5kg\",\n      \"sku\": \"RICE5\",\n      \"quantity\": 186,\n      \"revenue\": 1209000,\n      \"orders\": 141\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Sales by staff member",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/reports/staff",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "reports",
                "staff"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "store",
                  "value": "",
                  "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                  "disabled": true
                }
              ]
            },
            "description": "Permission: `pos.report` or `pos.sales`.\n\nScope: `reports:read`.\n\n`GET /reports/staff` · operationId `reports.staff`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/staff",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "staff"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "store",
                      "value": "",
                      "description": "\"all\" or a store id (needs pos.stores). Default: your store.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"staffId\": \"66f1c2a9e4b0a1b2c3d4e502\",\n      \"name\": \"Jane Doe\",\n      \"orders\": 210,\n      \"revenue\": 2744000,\n      \"averageOrder\": 13066.67\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Admin",
      "description": "Activity log, permissions and settings. API keys need the `admin` scope.",
      "item": [
        {
          "name": "Activity log",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/admin/activity-logs",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "admin",
                "activity-logs"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search text.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                },
                {
                  "key": "module",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "action",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "userId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "resource",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "resourceId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: success, failure.",
                  "disabled": true
                }
              ]
            },
            "description": "Who did what and when, across all modules (including API calls, marked with source \"api\"). Sensitive values in before/after snapshots are redacted.\n\nPermission: `admin.admin` or `logs/general.activity` or `logs/general.logs`.\n\nScope: `admin:read`.\n\n`GET /admin/activity-logs` · operationId `admin.activity`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/admin/activity-logs",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "admin",
                    "activity-logs"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search text.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    },
                    {
                      "key": "module",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "action",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "userId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "resource",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "resourceId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: success, failure.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e518\",\n      \"at\": \"2026-10-02T14:05:00.000Z\",\n      \"module\": \"pos\",\n      \"action\": \"update\",\n      \"resource\": \"pos_product\",\n      \"resourceId\": \"66f1c2a9e4b0a1b2c3d4e503\",\n      \"description\": \"Updated product Rice 5kg (API, token)\",\n      \"status\": \"success\",\n      \"user\": {\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"source\": \"api\",\n      \"ip\": \"102.89.1.20\",\n      \"method\": \"PATCH\",\n      \"path\": \"/api/v1/products/66f1c2a9e4b0a1b2c3d4e503\",\n      \"requestId\": \"106213322361546\",\n      \"before\": {\n        \"name\": \"Rice 5 kg\"\n      },\n      \"after\": {\n        \"name\": \"Rice 5kg\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Permission catalogue",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/admin/permissions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "admin",
                "permissions"
              ]
            },
            "description": "Every menu and permission key the app knows, as used by PUT /users/{id}/permissions.\n\nPermission: `admin.permission` or `admin.admin`.\n\nScope: `admin:read`.\n\n`GET /admin/permissions` · operationId `admin.permissions`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/admin/permissions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "admin",
                    "permissions"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"menu\": \"pos\",\n      \"name\": \"POS\",\n      \"permissions\": {\n        \"pos\": \"View POS\",\n        \"products\": \"View Products\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Main settings (no secrets)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/admin/settings",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "admin",
                "settings"
              ]
            },
            "description": "Permission: `pos.setting` or `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /admin/settings` · operationId `admin.settings`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/admin/settings",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "admin",
                    "settings"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"vatRate\": 7.5,\n    \"currencySymbol\": \"NGN\",\n    \"lowStockAlert\": true,\n    \"enableOnlineOrder\": true,\n    \"minOrderAmount\": 0,\n    \"orderPrepTime\": 20,\n    \"notificationEmail\": \"owner@example.com\",\n    \"messaging\": {\n      \"emailConfigured\": true,\n      \"fromEmail\": \"shop@example.com\",\n      \"fromName\": \"Main Street\",\n      \"smsConfigured\": false,\n      \"smsProvider\": \"\",\n      \"sendOrderConfirmation\": true,\n      \"enableSmsNotifications\": false,\n      \"sendWelcomeEmails\": false\n    },\n    \"api\": {\n      \"keys\": 2,\n      \"activeKeys\": 1\n    },\n    \"webhooks\": 1,\n    \"maintenance\": {\n      \"enabled\": false\n    }\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Notifications",
      "description": "Your own in-app notifications (the bell). No extra permission needed. API keys need the `notifications` scope, or plain read/write.",
      "item": [
        {
          "name": "List your notifications",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/notifications",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "notifications"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "unread",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "",
                  "description": "",
                  "disabled": true
                }
              ]
            },
            "description": "Any signed-in user.\n\nScope: `notifications:read`.\n\n`GET /notifications` · operationId `notifications.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/notifications",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "notifications"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "unread",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "category",
                      "value": "",
                      "description": "",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"66f1c2a9e4b0a1b2c3d4e530\",\n      \"type\": \"stock\",\n      \"icon\": \"fa-box\",\n      \"title\": \"Low stock: Rice 5kg\",\n      \"message\": \"Only 4 left at Main Street.\",\n      \"link\": \"/inventory\",\n      \"category\": \"inventory\",\n      \"event\": \"inventory.low_stock\",\n      \"priority\": \"high\",\n      \"read\": false,\n      \"readAt\": null,\n      \"from\": \"System\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Mark a notification as read",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/notifications/:id/read",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "notifications",
                ":id",
                "read"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^([a-f0-9]{24}|all)$"
                }
              ]
            },
            "description": "Any signed-in user.\n\nScope: `notifications:write`.\n\n`POST /notifications/{id}/read` · operationId `notifications.read`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/notifications/:id/read",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "notifications",
                    ":id",
                    "read"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^([a-f0-9]{24}|all)$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"updated\": 1\n  }\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Webhooks",
      "description": "Send events to other systems. Each delivery is a signed JSON POST (see the X-Webhook-Signature header: HMAC-SHA256 of \"<timestamp>.<body>\" with the webhook secret), retried with growing delays when the receiver is down. Needs pos.onlinestore; API keys need the `admin` scope.",
      "item": [
        {
          "name": "Events you can subscribe to",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/event-types",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "event-types"
              ]
            },
            "description": "Any signed-in user.\n\nScope: `admin:read`.\n\n`GET /event-types` · operationId `webhooks.eventTypes`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/event-types",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "event-types"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"name\": \"order.created\",\n      \"group\": \"Orders\",\n      \"description\": \"A sale or online order was placed.\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "List webhooks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "Permission: `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /webhooks` · operationId `webhooks.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n      \"name\": \"Accounting sync\",\n      \"url\": \"https://example.com/hooks/pos\",\n      \"events\": [\n        \"order.created\",\n        \"refund.created\"\n      ],\n      \"event\": \"order.created\",\n      \"status\": \"active\",\n      \"retryCount\": 3,\n      \"signed\": true,\n      \"secretHint\": \"whsec_…9f0e\",\n      \"lastDeliveryAt\": \"2026-10-02T14:05:00.000Z\",\n      \"lastStatus\": \"success\",\n      \"lastError\": null,\n      \"consecutiveFailures\": 0,\n      \"createdAt\": \"2026-10-01T09:30:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Create a webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks"
              ]
            },
            "description": "The response includes `secret` once. Keep it to check signatures; afterwards only a hint is shown.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`POST /webhooks` · operationId `webhooks.create`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"url\": \"https://example.com/hooks/pos\",\n  \"events\": [\n    \"order.created\",\n    \"order.updated\"\n  ],\n  \"status\": \"active\",\n  \"retryCount\": 3\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"\",\n  \"url\": \"https://example.com/hooks/pos\",\n  \"events\": [\n    \"order.created\",\n    \"order.updated\"\n  ],\n  \"status\": \"active\",\n  \"retryCount\": 3\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"name\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"events\": [\n      \"order.created\",\n      \"refund.created\"\n    ],\n    \"event\": \"order.created\",\n    \"status\": \"active\",\n    \"retryCount\": 3,\n    \"signed\": true,\n    \"secretHint\": \"whsec_…9f0e\",\n    \"lastDeliveryAt\": \"2026-10-02T14:05:00.000Z\",\n    \"lastStatus\": \"success\",\n    \"lastError\": null,\n    \"consecutiveFailures\": 0,\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\",\n    \"secret\": \"whsec_<secret shown once>\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Get a webhook",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                }
              ]
            },
            "description": "Permission: `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /webhooks/{id}` · operationId `webhooks.get`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"name\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"events\": [\n      \"order.created\",\n      \"refund.created\"\n    ],\n    \"event\": \"order.created\",\n    \"status\": \"active\",\n    \"retryCount\": 3,\n    \"signed\": true,\n    \"secretHint\": \"whsec_…9f0e\",\n    \"lastDeliveryAt\": \"2026-10-02T14:05:00.000Z\",\n    \"lastStatus\": \"success\",\n    \"lastError\": null,\n    \"consecutiveFailures\": 0,\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Change a webhook",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                }
              ]
            },
            "description": "Permission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`PATCH /webhooks/{id}` · operationId `webhooks.update`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"events\": [\n    \"order.created\",\n    \"order.updated\"\n  ],\n  \"status\": \"active\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"events\": [\n    \"order.created\",\n    \"order.updated\"\n  ],\n  \"status\": \"active\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"name\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"events\": [\n      \"order.created\",\n      \"refund.created\"\n    ],\n    \"event\": \"order.created\",\n    \"status\": \"active\",\n    \"retryCount\": 3,\n    \"signed\": true,\n    \"secretHint\": \"whsec_…9f0e\",\n    \"lastDeliveryAt\": \"2026-10-02T14:05:00.000Z\",\n    \"lastStatus\": \"success\",\n    \"lastError\": null,\n    \"consecutiveFailures\": 0,\n    \"createdAt\": \"2026-10-01T09:30:00.000Z\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Delete a webhook",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                }
              ]
            },
            "description": "Permission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`DELETE /webhooks/{id}` · operationId `webhooks.delete`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Send a test event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/:id/test",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                }
              ]
            },
            "description": "Sends a `webhook.test` event to this webhook now (even if it is inactive) and returns the result.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`POST /webhooks/{id}/test` · operationId `webhooks.test`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks/:id/test",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks",
                    ":id",
                    "test"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"deliveryId\": \"whd_5b1e9a0c7d2f4e6a8b3c1d0e\",\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"webhookName\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"event\": \"webhook.test\",\n    \"eventId\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n    \"status\": \"success\",\n    \"test\": true,\n    \"signed\": true,\n    \"attempts\": 1,\n    \"maxAttempts\": 4,\n    \"nextAttemptAt\": null,\n    \"lastAttemptAt\": \"2026-10-02T14:05:00.000Z\",\n    \"deliveredAt\": \"2026-10-02T14:05:00.000Z\",\n    \"responseStatus\": 200,\n    \"durationMs\": 182,\n    \"error\": \"\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"payload\": {\n      \"id\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n      \"event\": \"order.created\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"source\": \"api\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"actor\": {\n        \"type\": \"user\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"data\": {\n        \"order\": {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n          \"orderNumber\": \"ORD1790904240356987\",\n          \"status\": \"confirmed\",\n          \"total\": {\n            \"amount\": 13975,\n            \"currency\": \"NGN\"\n          }\n        }\n      }\n    },\n    \"responseBody\": \"{\\\"received\\\":true}\",\n    \"history\": [\n      {\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"status\": \"success\",\n        \"responseStatus\": 200,\n        \"durationMs\": 182,\n        \"error\": \"\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Create a new signing secret",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhooks/:id/secret",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhooks",
                ":id",
                "secret"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                }
              ]
            },
            "description": "Replaces the signing secret; the new one is returned once. Deliveries from now on are signed with it.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`POST /webhooks/{id}/secret` · operationId `webhooks.secret`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhooks/:id/secret",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhooks",
                    ":id",
                    "secret"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^wh_[a-f0-9]{8,32}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"secret\": \"whsec_<secret shown once>\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Delivery log",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-deliveries",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-deliveries"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "webhookId",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "event",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "One of: pending, retrying, success, failed, cancelled.",
                  "disabled": true
                }
              ]
            },
            "description": "Newest first. Each delivery is one event sent to one webhook, with its attempts.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /webhook-deliveries` · operationId `webhooks.deliveries`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhook-deliveries",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhook-deliveries"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "webhookId",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "event",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "One of: pending, retrying, success, failed, cancelled.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"deliveryId\": \"whd_5b1e9a0c7d2f4e6a8b3c1d0e\",\n      \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n      \"webhookName\": \"Accounting sync\",\n      \"url\": \"https://example.com/hooks/pos\",\n      \"event\": \"order.created\",\n      \"eventId\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n      \"status\": \"success\",\n      \"test\": false,\n      \"signed\": true,\n      \"attempts\": 1,\n      \"maxAttempts\": 4,\n      \"nextAttemptAt\": null,\n      \"lastAttemptAt\": \"2026-10-02T14:05:00.000Z\",\n      \"deliveredAt\": \"2026-10-02T14:05:00.000Z\",\n      \"responseStatus\": 200,\n      \"durationMs\": 182,\n      \"error\": \"\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Get a delivery",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-deliveries/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-deliveries",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^whd_[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Includes the payload that was sent, the start of the response, and every attempt.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /webhook-deliveries/{id}` · operationId `webhooks.delivery`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhook-deliveries/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhook-deliveries",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^whd_[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"deliveryId\": \"whd_5b1e9a0c7d2f4e6a8b3c1d0e\",\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"webhookName\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"event\": \"order.created\",\n    \"eventId\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n    \"status\": \"success\",\n    \"test\": false,\n    \"signed\": true,\n    \"attempts\": 1,\n    \"maxAttempts\": 4,\n    \"nextAttemptAt\": null,\n    \"lastAttemptAt\": \"2026-10-02T14:05:00.000Z\",\n    \"deliveredAt\": \"2026-10-02T14:05:00.000Z\",\n    \"responseStatus\": 200,\n    \"durationMs\": 182,\n    \"error\": \"\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"payload\": {\n      \"id\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n      \"event\": \"order.created\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"source\": \"api\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"actor\": {\n        \"type\": \"user\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"data\": {\n        \"order\": {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n          \"orderNumber\": \"ORD1790904240356987\",\n          \"status\": \"confirmed\",\n          \"total\": {\n            \"amount\": 13975,\n            \"currency\": \"NGN\"\n          }\n        }\n      }\n    },\n    \"responseBody\": \"{\\\"received\\\":true}\",\n    \"history\": [\n      {\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"status\": \"success\",\n        \"responseStatus\": 200,\n        \"durationMs\": 182,\n        \"error\": \"\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Send a delivery again",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-deliveries/:id/retry",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-deliveries",
                ":id",
                "retry"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Pattern: ^whd_[a-f0-9]{24}$"
                }
              ]
            },
            "description": "Permission: `pos.onlinestore`.\n\nScope: `admin:write`.\n\n`POST /webhook-deliveries/{id}/retry` · operationId `webhooks.retry`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/webhook-deliveries/:id/retry",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "webhook-deliveries",
                    ":id",
                    "retry"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "",
                      "description": "Pattern: ^whd_[a-f0-9]{24}$"
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"deliveryId\": \"whd_5b1e9a0c7d2f4e6a8b3c1d0e\",\n    \"webhookId\": \"wh_3f9c0a1b2c3d4e5f\",\n    \"webhookName\": \"Accounting sync\",\n    \"url\": \"https://example.com/hooks/pos\",\n    \"event\": \"order.created\",\n    \"eventId\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n    \"status\": \"success\",\n    \"test\": false,\n    \"signed\": true,\n    \"attempts\": 1,\n    \"maxAttempts\": 4,\n    \"nextAttemptAt\": null,\n    \"lastAttemptAt\": \"2026-10-02T14:05:00.000Z\",\n    \"deliveredAt\": \"2026-10-02T14:05:00.000Z\",\n    \"responseStatus\": 200,\n    \"durationMs\": 182,\n    \"error\": \"\",\n    \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n    \"payload\": {\n      \"id\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n      \"event\": \"order.created\",\n      \"createdAt\": \"2026-10-02T14:05:00.000Z\",\n      \"source\": \"api\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"actor\": {\n        \"type\": \"user\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"data\": {\n        \"order\": {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n          \"orderNumber\": \"ORD1790904240356987\",\n          \"status\": \"confirmed\",\n          \"total\": {\n            \"amount\": 13975,\n            \"currency\": \"NGN\"\n          }\n        }\n      }\n    },\n    \"responseBody\": \"{\\\"received\\\":true}\",\n    \"history\": [\n      {\n        \"at\": \"2026-10-02T14:05:00.000Z\",\n        \"status\": \"success\",\n        \"responseStatus\": 200,\n        \"durationMs\": 182,\n        \"error\": \"\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "Event history",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "events"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Page number (starts at 1).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "25",
                  "description": "Items per page (max 100).",
                  "disabled": true
                },
                {
                  "key": "event",
                  "value": "",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only items on or after this date (YYYY-MM-DD).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                  "disabled": true
                }
              ]
            },
            "description": "Everything that happened (orders, payments, customers, stock, HR…), newest first, with the data sent to webhooks.\n\nPermission: `pos.onlinestore`.\n\nScope: `admin:read`.\n\n`GET /events` · operationId `events.list`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/events",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "events"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1",
                      "description": "Page number (starts at 1).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "25",
                      "description": "Items per page (max 100).",
                      "disabled": true
                    },
                    {
                      "key": "event",
                      "value": "",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only items on or after this date (YYYY-MM-DD).",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only items on or before this date (YYYY-MM-DD, whole day included).",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"id\": \"evt_9b2f1c0d4e5a6b7c8d9e0f1a\",\n      \"event\": \"order.created\",\n      \"source\": \"api\",\n      \"occurredAt\": \"2026-10-02T14:05:00.000Z\",\n      \"storeId\": \"66f1c2a9e4b0a1b2c3d4e501\",\n      \"actor\": {\n        \"type\": \"user\",\n        \"id\": \"66f1c2a9e4b0a1b2c3d4e502\",\n        \"name\": \"Jane Doe\"\n      },\n      \"webhooks\": 1,\n      \"data\": {\n        \"order\": {\n          \"id\": \"66f1c2a9e4b0a1b2c3d4e505\",\n          \"orderNumber\": \"ORD1790904240356987\",\n          \"status\": \"confirmed\",\n          \"total\": {\n            \"amount\": 13975,\n            \"currency\": \"NGN\"\n          }\n        }\n      }\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "AI assistant",
      "description": "Questions about sales, stock, customers, finance, HR and projects, answered from this installation's data without any internet service. API keys need the `ai` scope (or plain read) plus the scope of the data asked about.",
      "item": [
        {
          "name": "Ask a question",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/ai/ask",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "ai",
                "ask"
              ]
            },
            "description": "`status` is `answered`, `no_match` (with `suggestions`) or `denied` (the user or key may not see that data). Answers can include `facts` (headline figures), a `table` and a `chart`; money values are plain numbers in the store currency (`currency`).\n\nAny signed-in user.\n\nScope: `ai:read`.\n\n`POST /ai/ask` · operationId `ai.ask`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"question\": \"How much did we sell this month?\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/ai/ask",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "ai",
                    "ask"
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"question\": \"How much did we sell this month?\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": {\n    \"status\": \"answered\",\n    \"question\": \"How much did we sell this month?\",\n    \"intent\": \"sales.summary\",\n    \"area\": \"sales\",\n    \"areaLabel\": \"Sales\",\n    \"period\": {\n      \"label\": \"this month\",\n      \"from\": \"2026-10-01T00:00:00.000Z\",\n      \"to\": \"2026-10-02T23:59:59.999Z\"\n    },\n    \"store\": null,\n    \"currency\": \"NGN\",\n    \"corrections\": [],\n    \"link\": {\n      \"href\": \"/pos/report\",\n      \"label\": \"Sales report\"\n    },\n    \"answer\": \"You sold NGN845,000 this month at Main Street from 64 orders (average NGN13,203.13). That is +12.5% compared with the previous period.\",\n    \"facts\": [\n      {\n        \"label\": \"Revenue\",\n        \"value\": 845000,\n        \"type\": \"money\"\n      },\n      {\n        \"label\": \"Orders\",\n        \"value\": 64,\n        \"type\": \"number\"\n      },\n      {\n        \"label\": \"Average order\",\n        \"value\": 13203.13,\n        \"type\": \"money\"\n      },\n      {\n        \"label\": \"Items sold\",\n        \"value\": 211,\n        \"type\": \"number\"\n      }\n    ],\n    \"chart\": {\n      \"type\": \"line\",\n      \"labels\": [\n        \"2026-10-01\",\n        \"2026-10-02\"\n      ],\n      \"series\": [\n        {\n          \"label\": \"Revenue\",\n          \"data\": [\n            402000,\n            443000\n          ]\n        }\n      ],\n      \"format\": \"money\"\n    }\n  }\n}"
            }
          ]
        },
        {
          "name": "Questions you can ask",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/ai/suggestions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "ai",
                "suggestions"
              ]
            },
            "description": "Example questions grouped by area, limited to the data this user (and key) may see.\n\nAny signed-in user.\n\nScope: `ai:read`.\n\n`GET /ai/suggestions` · operationId `ai.suggestions`"
          },
          "response": [
            {
              "name": "200 Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/ai/suggestions",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "ai",
                    "suggestions"
                  ]
                }
              },
              "status": "Success",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "body": "{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"data\": [\n    {\n      \"area\": \"sales\",\n      \"label\": \"Sales\",\n      \"questions\": [\n        \"How much did we sell this month?\"\n      ]\n    },\n    {\n      \"area\": \"inventory\",\n      \"label\": \"Inventory\",\n      \"questions\": [\n        \"Which products are out of stock?\"\n      ]\n    }\n  ]\n}"
            }
          ]
        }
      ]
    }
  ]
}