{"openapi":"3.1.0","info":{"title":"NakPOS API","version":"1.0.0","description":"Generated API contract for NakPOS mobile, integration, and AI endpoints."},"servers":[{"url":"https:\/\/pos.itglonline.com\/api\/v1"}],"components":{"securitySchemes":{"sanctumBearer":{"type":"http","scheme":"bearer","bearerFormat":"Sanctum"}}},"paths":{"\/auth\/login":{"post":{"summary":"User Login","description":"Authenticate a user and issue a Sanctum token for API requests.","operationId":"api_v1_auth_login","tags":["Authentication"],"x-route-name":"api.v1.auth.login","x-rate-limit":"5\/minute","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"User email address"},"password":{"type":"string","description":"User password"},"device_name":{"type":"string","description":"Optional device label"},"store_id":{"type":"integer","description":"Preferred store context for login"},"two_factor_code":{"type":"string","description":"Two-factor code when required"}},"required":["email","password"]},"example":{"email":"cashier@example.com","password":"secret123","device_name":"iPhone 15 Pro","store_id":1}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"token":"1|abc123xyz...","user":{"id":1,"name":"John Doe","email":"cashier@example.com","role":{"id":2,"name":"Cashier","slug":"cashier"},"store_id":1,"store_name":"Main Store","is_super_admin":false,"has_two_factor":false},"permissions":["pos.access","sales.create","customers.view"],"store_id":1}}}}},"422":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"The given data was invalid.","errors":{"email":["The provided credentials are incorrect."]}}}}}}}},"\/auth\/logout":{"post":{"summary":"User Logout","description":"Revoke the current token and end the current API session.","operationId":"api_v1_auth_logout","tags":["Authentication"],"x-route-name":"api.v1.auth.logout","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"message":"Successfully logged out."}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/auth\/me":{"get":{"summary":"Current User Profile","description":"Return the authenticated user profile, permissions, and discount limits.","operationId":"api_v1_auth_me","tags":["Authentication"],"x-route-name":"api.v1.auth.me","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/bundles":{"get":{"summary":"List Bundles","description":"Get paginated bundles with optional store and validity filters.","operationId":"api_v1_bundles_index","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"post":{"summary":"Create Bundles","description":"Submit a Bundles request to \/bundles.","operationId":"api_v1_bundles_store","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.store","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/bundles\/calculate":{"post":{"summary":"Calculate Bundles","description":"Submit a Bundles request to \/bundles\/calculate.","operationId":"api_v1_bundles_calculate","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.calculate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/bundles\/{bundle}":{"delete":{"summary":"Delete Bundles","description":"Delete Bundles data through \/bundles\/{bundle}.","operationId":"api_v1_bundles_destroy","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.destroy","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"bundle","in":"path","required":true,"description":"Path parameter: Bundle","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"message":"Operation completed successfully."}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"get":{"summary":"Get Bundles","description":"Retrieve Bundles data from \/bundles\/{bundle}.","operationId":"api_v1_bundles_show","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"bundle","in":"path","required":true,"description":"Path parameter: Bundle","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"put":{"summary":"Update Bundles","description":"Update Bundles data through \/bundles\/{bundle}.","operationId":"api_v1_bundles_update","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.update","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"bundle","in":"path","required":true,"description":"Path parameter: Bundle","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/bundles\/{bundle}\/availability":{"get":{"summary":"Availability","description":"Retrieve Bundles data from \/bundles\/{bundle}\/availability.","operationId":"api_v1_bundles_availability","tags":["Pricing & Bundles"],"x-route-name":"api.v1.bundles.availability","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"bundle","in":"path","required":true,"description":"Path parameter: Bundle","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/categories":{"get":{"summary":"List Categories","description":"Get paginated categories with optional hierarchy and count metadata.","operationId":"api_v1_categories_index","tags":["Products & Catalog"],"x-route-name":"api.v1.categories.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"post":{"summary":"Create Categories","description":"Submit a Categories request to \/categories.","operationId":"api_v1_categories_store","tags":["Products & Catalog"],"x-route-name":"api.v1.categories.store","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/categories\/{category}":{"delete":{"summary":"Delete Categories","description":"Delete Categories data through \/categories\/{category}.","operationId":"api_v1_categories_destroy","tags":["Products & Catalog"],"x-route-name":"api.v1.categories.destroy","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"category","in":"path","required":true,"description":"Path parameter: Category","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"message":"Operation completed successfully."}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"get":{"summary":"Get Categories","description":"Retrieve Categories data from \/categories\/{category}.","operationId":"api_v1_categories_show","tags":["Products & Catalog"],"x-route-name":"api.v1.categories.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"category","in":"path","required":true,"description":"Path parameter: Category","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"put":{"summary":"Update Categories","description":"Update Categories data through \/categories\/{category}.","operationId":"api_v1_categories_update","tags":["Products & Catalog"],"x-route-name":"api.v1.categories.update","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"category","in":"path","required":true,"description":"Path parameter: Category","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/currencies":{"get":{"summary":"List Currencies","description":"Retrieve Currencies data from \/currencies.","operationId":"api_v1_currencies_index","tags":["Pricing & Bundles"],"x-route-name":"api.v1.currencies.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/currencies\/convert":{"get":{"summary":"Convert","description":"Retrieve Currencies data from \/currencies\/convert.","operationId":"api_v1_currencies_convert","tags":["Pricing & Bundles"],"x-route-name":"api.v1.currencies.convert","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/currencies\/{currency}":{"get":{"summary":"Get Currencies","description":"Retrieve Currencies data from \/currencies\/{currency}.","operationId":"api_v1_currencies_show","tags":["Pricing & Bundles"],"x-route-name":"api.v1.currencies.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"currency","in":"path","required":true,"description":"Path parameter: Currency","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/customers":{"get":{"summary":"List Customers","description":"Get paginated customers with status and search filters.","operationId":"api_v1_customers_index","tags":["Customers"],"x-route-name":"api.v1.customers.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"post":{"summary":"Create Customers","description":"Submit a Customers request to \/customers.","operationId":"api_v1_customers_store","tags":["Customers"],"x-route-name":"api.v1.customers.store","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Field: Name"},"email":{"type":"string","description":"Field: Email"},"phone":{"type":"string","description":"Field: Phone"},"address":{"type":"string","description":"Field: Address"},"customer_group_id":{"type":"integer","description":"Field: Customer Group Id"}},"required":["name"]},"example":{"name":"example","email":"user@example.com","phone":"example","address":"example","customer_group_id":1}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/customers\/search":{"get":{"summary":"Search Customers","description":"Search customers by name, phone, email, or address for quick POS selection.","operationId":"api_v1_customers_search","tags":["Customers"],"x-route-name":"api.v1.customers.search","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/customers\/{customer}":{"delete":{"summary":"Delete Customers","description":"Delete Customers data through \/customers\/{customer}.","operationId":"api_v1_customers_destroy","tags":["Customers"],"x-route-name":"api.v1.customers.destroy","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"customer","in":"path","required":true,"description":"Path parameter: Customer","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"message":"Operation completed successfully."}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"get":{"summary":"Get Customers","description":"Retrieve Customers data from \/customers\/{customer}.","operationId":"api_v1_customers_show","tags":["Customers"],"x-route-name":"api.v1.customers.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"customer","in":"path","required":true,"description":"Path parameter: Customer","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"put":{"summary":"Update Customers","description":"Update Customers data through \/customers\/{customer}.","operationId":"api_v1_customers_update","tags":["Customers"],"x-route-name":"api.v1.customers.update","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"customer","in":"path","required":true,"description":"Path parameter: Customer","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/customers":{"get":{"summary":"Integration Data: Customers","description":"Return paginated customer data for external integrations.","operationId":"api_v1_integration_data_customers_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.customers.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/customers\/{customer}":{"get":{"summary":"Get Integration Data Customers","description":"Retrieve Integration Data Customers data from \/integration\/data\/customers\/{customer}.","operationId":"api_v1_integration_data_customers_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.customers.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"customer","in":"path","required":true,"description":"Path parameter: Customer","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/inventory":{"get":{"summary":"List Integration Data Inventory","description":"Retrieve Integration Data Inventory data from \/integration\/data\/inventory.","operationId":"api_v1_integration_data_inventory_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.inventory.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/invoices":{"get":{"summary":"List Integration Data Invoices","description":"Retrieve Integration Data Invoices data from \/integration\/data\/invoices.","operationId":"api_v1_integration_data_invoices_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.invoices.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/invoices\/{invoice}":{"get":{"summary":"Get Integration Data Invoices","description":"Retrieve Integration Data Invoices data from \/integration\/data\/invoices\/{invoice}.","operationId":"api_v1_integration_data_invoices_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.invoices.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"invoice","in":"path","required":true,"description":"Path parameter: Invoice","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/items":{"get":{"summary":"Integration Data: Items","description":"Return paginated item data for external integrations.","operationId":"api_v1_integration_data_items_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.items.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/returns":{"get":{"summary":"List Integration Data Returns","description":"Retrieve Integration Data Returns data from \/integration\/data\/returns.","operationId":"api_v1_integration_data_returns_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.returns.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/returns\/{saleReturn}":{"get":{"summary":"Get Integration Data Returns","description":"Retrieve Integration Data Returns data from \/integration\/data\/returns\/{saleReturn}.","operationId":"api_v1_integration_data_returns_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.returns.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/sales":{"get":{"summary":"List Integration Data Sales","description":"Retrieve Integration Data Sales data from \/integration\/data\/sales.","operationId":"api_v1_integration_data_sales_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.sales.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/sales\/{sale}":{"get":{"summary":"Get Integration Data Sales","description":"Retrieve Integration Data Sales data from \/integration\/data\/sales\/{sale}.","operationId":"api_v1_integration_data_sales_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.sales.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"sale","in":"path","required":true,"description":"Path parameter: Sale","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/stores":{"get":{"summary":"Integration Data: Stores","description":"Return store reference data for external integrations.","operationId":"api_v1_integration_data_stores_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.stores.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/stores\/{store}":{"get":{"summary":"Get Integration Data Stores","description":"Retrieve Integration Data Stores data from \/integration\/data\/stores\/{store}.","operationId":"api_v1_integration_data_stores_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.stores.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"store","in":"path","required":true,"description":"Path parameter: Store","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/warehouses":{"get":{"summary":"Integration Data: Warehouses","description":"Return warehouse reference data for external integrations.","operationId":"api_v1_integration_data_warehouses_index","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.warehouses.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/data\/warehouses\/{warehouse}":{"get":{"summary":"Get Integration Data Warehouses","description":"Retrieve Integration Data Warehouses data from \/integration\/data\/warehouses\/{warehouse}.","operationId":"api_v1_integration_data_warehouses_show","tags":["Integration Data"],"x-route-name":"api.v1.integration.data.warehouses.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"warehouse","in":"path","required":true,"description":"Path parameter: Warehouse","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/cashier":{"get":{"summary":"Cashier","description":"Retrieve Integration Reports data from \/integration\/reports\/cashier.","operationId":"api_v1_integration_reports_cashier","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.cashier","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/cashier\/{cashier}":{"get":{"summary":"Detail","description":"Retrieve Integration Reports Cashier data from \/integration\/reports\/cashier\/{cashier}.","operationId":"api_v1_integration_reports_cashier_detail","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.cashier.detail","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"cashier","in":"path","required":true,"description":"Path parameter: Cashier","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/closeout":{"get":{"summary":"Closeout","description":"Retrieve Integration Reports data from \/integration\/reports\/closeout.","operationId":"api_v1_integration_reports_closeout","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.closeout","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/customers":{"get":{"summary":"Customers","description":"Retrieve Integration Reports data from \/integration\/reports\/customers.","operationId":"api_v1_integration_reports_customers","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.customers","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/discounts":{"get":{"summary":"Discounts","description":"Retrieve Integration Reports data from \/integration\/reports\/discounts.","operationId":"api_v1_integration_reports_discounts","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.discounts","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/heatmap":{"get":{"summary":"Heatmap","description":"Retrieve Integration Reports data from \/integration\/reports\/heatmap.","operationId":"api_v1_integration_reports_heatmap","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.heatmap","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/damage-spoilage":{"get":{"summary":"Damage Spoilage","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/damage-spoilage.","operationId":"api_v1_integration_reports_inventory_damage-spoilage","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.damage-spoilage","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/dead-stock":{"get":{"summary":"Dead Stock","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/dead-stock.","operationId":"api_v1_integration_reports_inventory_dead-stock","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.dead-stock","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/movement":{"get":{"summary":"Movement","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/movement.","operationId":"api_v1_integration_reports_inventory_movement","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.movement","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/overview":{"get":{"summary":"Overview","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/overview.","operationId":"api_v1_integration_reports_inventory_overview","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.overview","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/replenishment":{"get":{"summary":"Replenishment","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/replenishment.","operationId":"api_v1_integration_reports_inventory_replenishment","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.replenishment","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/stock":{"get":{"summary":"Stock","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/stock.","operationId":"api_v1_integration_reports_inventory_stock","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.stock","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/turns":{"get":{"summary":"Turns","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/turns.","operationId":"api_v1_integration_reports_inventory_turns","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.turns","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/inventory\/valuation":{"get":{"summary":"Valuation","description":"Retrieve Integration Reports Inventory data from \/integration\/reports\/inventory\/valuation.","operationId":"api_v1_integration_reports_inventory_valuation","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.inventory.valuation","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/invoices":{"get":{"summary":"Invoices","description":"Retrieve Integration Reports data from \/integration\/reports\/invoices.","operationId":"api_v1_integration_reports_invoices","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.invoices","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/invoices\/aging":{"get":{"summary":"Aging","description":"Retrieve Integration Reports Invoices data from \/integration\/reports\/invoices\/aging.","operationId":"api_v1_integration_reports_invoices_aging","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.invoices.aging","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/invoices\/credit-notes":{"get":{"summary":"Credit Notes","description":"Retrieve Integration Reports Invoices data from \/integration\/reports\/invoices\/credit-notes.","operationId":"api_v1_integration_reports_invoices_credit-notes","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.invoices.credit-notes","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/invoices\/dso":{"get":{"summary":"Dso","description":"Retrieve Integration Reports Invoices data from \/integration\/reports\/invoices\/dso.","operationId":"api_v1_integration_reports_invoices_dso","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.invoices.dso","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/invoices\/funnel":{"get":{"summary":"Funnel","description":"Retrieve Integration Reports Invoices data from \/integration\/reports\/invoices\/funnel.","operationId":"api_v1_integration_reports_invoices_funnel","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.invoices.funnel","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/overview":{"get":{"summary":"Integration Report Overview","description":"Return high-level report overview data for external consumers.","operationId":"api_v1_integration_reports_overview","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.overview","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/payments":{"get":{"summary":"Payments","description":"Retrieve Integration Reports data from \/integration\/reports\/payments.","operationId":"api_v1_integration_reports_payments","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.payments","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/price-source":{"get":{"summary":"Price Source","description":"Retrieve Integration Reports data from \/integration\/reports\/price-source.","operationId":"api_v1_integration_reports_price-source","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.price-source","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/products":{"get":{"summary":"Products","description":"Retrieve Integration Reports data from \/integration\/reports\/products.","operationId":"api_v1_integration_reports_products","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.products","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/products\/abc":{"get":{"summary":"Abc","description":"Retrieve Integration Reports Products data from \/integration\/reports\/products\/abc.","operationId":"api_v1_integration_reports_products_abc","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.products.abc","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/profit":{"get":{"summary":"Profit","description":"Retrieve Integration Reports data from \/integration\/reports\/profit.","operationId":"api_v1_integration_reports_profit","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.profit","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/return-rate":{"get":{"summary":"Return Rate","description":"Retrieve Integration Reports data from \/integration\/reports\/return-rate.","operationId":"api_v1_integration_reports_return-rate","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.return-rate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/returns":{"get":{"summary":"Returns","description":"Retrieve Integration Reports data from \/integration\/reports\/returns.","operationId":"api_v1_integration_reports_returns","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.returns","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/revenue":{"get":{"summary":"Revenue","description":"Retrieve Integration Reports data from \/integration\/reports\/revenue.","operationId":"api_v1_integration_reports_revenue","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.revenue","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/sales":{"get":{"summary":"Integration Report Sales","description":"Return detailed sales reporting rows for external consumers.","operationId":"api_v1_integration_reports_sales","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.sales","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/stores":{"get":{"summary":"Stores","description":"Retrieve Integration Reports data from \/integration\/reports\/stores.","operationId":"api_v1_integration_reports_stores","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.stores","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/tax":{"get":{"summary":"Tax","description":"Retrieve Integration Reports data from \/integration\/reports\/tax.","operationId":"api_v1_integration_reports_tax","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.tax","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/reports\/voids":{"get":{"summary":"Voids","description":"Retrieve Integration Reports data from \/integration\/reports\/voids.","operationId":"api_v1_integration_reports_voids","tags":["Reporting"],"x-route-name":"api.v1.integration.reports.voids","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/sales":{"get":{"summary":"Daily Summary Pull (By Status)","description":"Pull sales for reporting and aggregation. Compatibility alias: `\/integrations\/sales`. Common scenarios include Store Rollup Pull and Warehouse Rollup Pull using `store_id` and `warehouse_id` filters.","operationId":"api_v1_integration_sales_index","tags":["Reporting"],"x-route-name":"api.v1.integration.sales.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"from","in":"query","description":"Start date (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"to","in":"query","description":"End date (YYYY-MM-DD)","schema":{"type":"string"}},{"name":"status","in":"query","description":"Sale status filter","schema":{"type":"string"}},{"name":"store_id","in":"query","description":"Optional store filter","schema":{"type":"integer"}},{"name":"warehouse_id","in":"query","description":"Optional warehouse filter","schema":{"type":"integer"}},{"name":"q","in":"query","description":"Free-text search on receipt, barcode, or reference","schema":{"type":"string"}},{"name":"per_page","in":"query","description":"Results per page (default: 50, max: 200)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":901,"receipt_number":"RCP-20260211-0001","status":"completed","store":{"id":1,"name":"Main Store"},"warehouse":{"id":2,"name":"Sales Floor"},"total_amount":245,"created_at":"2026-02-11T09:15:00Z"}],"meta":{"current_page":1,"last_page":3,"per_page":100,"total":467}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/integration\/sales\/{sale}":{"get":{"summary":"Incremental Sync Drilldown","description":"Use sale detail lookups to reconcile line items and payments flagged during reporting syncs. Compatibility alias: `\/integrations\/sales\/{sale}`.","operationId":"api_v1_integration_sales_show","tags":["Reporting"],"x-route-name":"api.v1.integration.sales.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"sale","in":"path","required":true,"description":"Path parameter: Sale","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/items":{"get":{"summary":"List Items","description":"Get paginated items with optional search by query, SKU, barcode, or related catalog metadata.","operationId":"api_v1_items_index","tags":["Products & Catalog"],"x-route-name":"api.v1.items.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"q","in":"query","description":"Search query","schema":{"type":"string"}},{"name":"search","in":"query","description":"Legacy search parameter alias for q","schema":{"type":"string"}},{"name":"per_page","in":"query","description":"Results per page (default: 50, max: 100)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}],"meta":{"current_page":1,"last_page":1,"per_page":50,"total":1}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/items\/check-name":{"get":{"summary":"Check Name","description":"Retrieve Items data from \/items\/check-name.","operationId":"api_v1_items_check-name","tags":["Products & Catalog"],"x-route-name":"api.v1.items.check-name","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/items\/{item}\/applicable-price-books":{"get":{"summary":"Applicable Price Books","description":"Retrieve Items data from \/items\/{item}\/applicable-price-books.","operationId":"api_v1_items_applicable-price-books","tags":["Products & Catalog"],"x-route-name":"api.v1.items.applicable-price-books","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"item","in":"path","required":true,"description":"Path parameter: Item","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/items\/{item}\/price":{"get":{"summary":"Price","description":"Retrieve Items data from \/items\/{item}\/price.","operationId":"api_v1_items_price","tags":["Products & Catalog"],"x-route-name":"api.v1.items.price","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"item","in":"path","required":true,"description":"Path parameter: Item","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/items\/{item}\/price-breakdown":{"get":{"summary":"Price Breakdown","description":"Retrieve Items data from \/items\/{item}\/price-breakdown.","operationId":"api_v1_items_price-breakdown","tags":["Products & Catalog"],"x-route-name":"api.v1.items.price-breakdown","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"item","in":"path","required":true,"description":"Path parameter: Item","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/payment-methods":{"get":{"summary":"List Payment Methods","description":"Retrieve Payment Methods data from \/payment-methods.","operationId":"api_v1_payment-methods_index","tags":["Products & Catalog"],"x-route-name":"api.v1.payment-methods.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/payment-methods\/{paymentMethod}":{"get":{"summary":"Get Payment Methods","description":"Retrieve Payment Methods data from \/payment-methods\/{paymentMethod}.","operationId":"api_v1_payment-methods_show","tags":["Products & Catalog"],"x-route-name":"api.v1.payment-methods.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"paymentMethod","in":"path","required":true,"description":"Path parameter: Payment Method","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/checkout":{"post":{"summary":"Create POS Checkout","description":"Validate, price, tax, and complete a POS sale.","operationId":"api_v1_pos_checkout","tags":["POS Operations"],"x-route-name":"api.v1.pos.checkout","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Field: Items"},"items.*.id":{"type":"string","description":"Field: Items * Id"},"items.*.qty":{"type":"number","description":"Field: Items * Qty"},"items.*.serial_number":{"type":"string","description":"Field: Items * Serial Number"},"items.*.price":{"type":"number","description":"Field: Items * Price"},"items.*.unit_id":{"type":"string","description":"Field: Items * Unit Id"},"items.*.base_quantity":{"type":"number","description":"Field: Items * Base Quantity"},"items.*.warehouse_id":{"type":"integer","description":"Field: Items * Warehouse Id"},"items.*.discount_type":{"type":"string","description":"Field: Items * Discount Type"},"items.*.discount_value":{"type":"number","description":"Field: Items * Discount Value"},"items.*.discount_amount":{"type":"number","description":"Field: Items * Discount Amount"},"items.*.discount_reason":{"type":"string","description":"Field: Items * Discount Reason"},"items.*.discount_approved_by":{"type":"string","description":"Field: Items * Discount Approved By"},"items.*.discount_approval_token":{"type":"string","description":"Field: Items * Discount Approval Token"},"payments":{"type":"array","description":"Field: Payments"},"payments.*.payment_method_code":{"type":"string","description":"Field: Payments * Payment Method Code"},"payments.*.payment_method_id":{"type":"string","description":"Field: Payments * Payment Method Id"},"payments.*.amount":{"type":"number","description":"Field: Payments * Amount"},"payments.*.tendered":{"type":"number","description":"Field: Payments * Tendered"},"payments.*.change":{"type":"number","description":"Field: Payments * Change"},"payments.*.reference":{"type":"string","description":"Field: Payments * Reference"},"payment_method":{"type":"string","description":"Field: Payment Method"},"payment_method_id":{"type":"string","description":"Field: Payment Method Id"},"total_amount":{"type":"number","description":"Field: Total Amount"},"subtotal":{"type":"number","description":"Field: Subtotal"},"customer_id":{"type":"string","description":"Field: Customer Id"},"reference":{"type":"string","description":"Field: Reference"},"cart_discount_type":{"type":"string","description":"Field: Cart Discount Type"},"cart_discount_value":{"type":"number","description":"Field: Cart Discount Value"},"cart_discount_amount":{"type":"number","description":"Field: Cart Discount Amount"},"cart_discount_reason":{"type":"string","description":"Field: Cart Discount Reason"},"cart_discount_approved_by":{"type":"string","description":"Field: Cart Discount Approved By"},"cart_discount_approval_token":{"type":"string","description":"Field: Cart Discount Approval Token"},"total_discount":{"type":"number","description":"Field: Total Discount"},"tax_exempt":{"type":"boolean","description":"Field: Tax Exempt"},"idempotency_key":{"type":"string","description":"Field: Idempotency Key"},"store_id":{"type":"integer","description":"Field: Store Id"},"offline_created_at":{"type":"string","description":"Field: Offline Created At"}},"required":["items","items.*.id","items.*.qty","payments","payments.*.payment_method_code","payments.*.amount","total_amount","idempotency_key","store_id"]},"example":{"items":[],"items.*.id":"example","items.*.qty":9.99,"items.*.serial_number":"example","items.*.price":9.99,"items.*.unit_id":"example","items.*.base_quantity":9.99,"items.*.warehouse_id":1,"items.*.discount_type":"example","items.*.discount_value":9.99,"items.*.discount_amount":9.99,"items.*.discount_reason":"example","items.*.discount_approved_by":"example","items.*.discount_approval_token":"example","payments":[],"payments.*.payment_method_code":"example","payments.*.payment_method_id":"example","payments.*.amount":9.99,"payments.*.tendered":9.99,"payments.*.change":9.99,"payments.*.reference":"example","payment_method":"example","payment_method_id":"example","total_amount":9.99,"subtotal":9.99,"customer_id":"example","reference":"example","cart_discount_type":"example","cart_discount_value":9.99,"cart_discount_amount":9.99,"cart_discount_reason":"example","cart_discount_approved_by":"example","cart_discount_approval_token":"example","total_discount":9.99,"tax_exempt":true,"idempotency_key":"example","store_id":1,"offline_created_at":"2026-03-16"}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/checkout\/validate":{"post":{"summary":"Validate","description":"Submit a Pos Checkout request to \/pos\/checkout\/validate.","operationId":"api_v1_pos_checkout_validate","tags":["POS Operations"],"x-route-name":"api.v1.pos.checkout.validate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/discount-limits":{"get":{"summary":"Discount Limits","description":"Retrieve Pos data from \/pos\/discount-limits.","operationId":"api_v1_pos_discount-limits","tags":["POS Operations"],"x-route-name":"api.v1.pos.discount-limits","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/discount\/approve":{"post":{"summary":"Approve","description":"Submit a Pos Discount request to \/pos\/discount\/approve.","operationId":"api_v1_pos_discount_approve","tags":["POS Operations"],"x-route-name":"api.v1.pos.discount.approve","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/products":{"get":{"summary":"List POS Products","description":"Get paginated POS-ready products with live price and stock data.","operationId":"api_v1_pos_products","tags":["POS Operations"],"x-route-name":"api.v1.pos.products","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/products\/search":{"get":{"summary":"Search POS Products","description":"Search POS products by name, SKU, or barcode.","operationId":"api_v1_pos_products_search","tags":["POS Operations"],"x-route-name":"api.v1.pos.products.search","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Field: Q","schema":{"type":"string"}},{"name":"store_id","in":"query","required":true,"description":"Field: Store Id","schema":{"type":"integer"}},{"name":"warehouse_id","in":"query","description":"Field: Warehouse Id","schema":{"type":"integer"}},{"name":"category_id","in":"query","description":"Field: Category Id","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"Field: Limit","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/products\/{item}":{"get":{"summary":"Get Pos Products","description":"Retrieve Pos Products data from \/pos\/products\/{item}.","operationId":"api_v1_pos_products_show","tags":["POS Operations"],"x-route-name":"api.v1.pos.products.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"item","in":"path","required":true,"description":"Path parameter: Item","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/session-status":{"get":{"summary":"POS Session Status","description":"Return POS readiness, including store access and active cashier session status.","operationId":"api_v1_pos_session-status","tags":["POS Operations"],"x-route-name":"api.v1.pos.session-status","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/tax\/calculate":{"post":{"summary":"Calculate POS Tax","description":"Return tax details for a POS cart before checkout.","operationId":"api_v1_pos_tax_calculate","tags":["POS Operations"],"x-route-name":"api.v1.pos.tax.calculate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pos\/tax\/info":{"get":{"summary":"Info","description":"Retrieve Pos Tax data from \/pos\/tax\/info.","operationId":"api_v1_pos_tax_info","tags":["POS Operations"],"x-route-name":"api.v1.pos.tax.info","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/price-books":{"get":{"summary":"List Price Books","description":"Retrieve Price Books data from \/price-books.","operationId":"api_v1_price-books_index","tags":["Products & Catalog"],"x-route-name":"api.v1.price-books.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/price-books\/{priceBook}":{"get":{"summary":"Get Price Books","description":"Retrieve Price Books data from \/price-books\/{priceBook}.","operationId":"api_v1_price-books_show","tags":["Products & Catalog"],"x-route-name":"api.v1.price-books.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"priceBook","in":"path","required":true,"description":"Path parameter: Price Book","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/prices\/bulk":{"post":{"summary":"Bulk","description":"Submit a Prices request to \/prices\/bulk.","operationId":"api_v1_prices_bulk","tags":["Other"],"x-route-name":"api.v1.prices.bulk","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing-rules":{"get":{"summary":"List Pricing Rules","description":"Get paginated pricing rules with optional store, validity, and relationship filters.","operationId":"api_v1_pricing-rules_index","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"post":{"summary":"Create Pricing Rules","description":"Submit a Pricing Rules request to \/pricing-rules.","operationId":"api_v1_pricing-rules_store","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.store","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing-rules\/evaluate":{"post":{"summary":"Evaluate","description":"Submit a Pricing Rules request to \/pricing-rules\/evaluate.","operationId":"api_v1_pricing-rules_evaluate","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.evaluate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing-rules\/{pricingRule}":{"delete":{"summary":"Delete Pricing Rules","description":"Delete Pricing Rules data through \/pricing-rules\/{pricingRule}.","operationId":"api_v1_pricing-rules_destroy","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.destroy","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"pricingRule","in":"path","required":true,"description":"Path parameter: Pricing Rule","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"message":"Operation completed successfully."}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"get":{"summary":"Get Pricing Rules","description":"Retrieve Pricing Rules data from \/pricing-rules\/{pricingRule}.","operationId":"api_v1_pricing-rules_show","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"pricingRule","in":"path","required":true,"description":"Path parameter: Pricing Rule","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"put":{"summary":"Update Pricing Rules","description":"Update Pricing Rules data through \/pricing-rules\/{pricingRule}.","operationId":"api_v1_pricing-rules_update","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.update","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"pricingRule","in":"path","required":true,"description":"Path parameter: Pricing Rule","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing-rules\/{pricingRule}\/toggle":{"post":{"summary":"Toggle Pricing Rules","description":"Submit a Pricing Rules request to \/pricing-rules\/{pricingRule}\/toggle.","operationId":"api_v1_pricing-rules_toggle","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing-rules.toggle","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"pricingRule","in":"path","required":true,"description":"Path parameter: Pricing Rule","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/calculate":{"post":{"summary":"Calculate Price","description":"Evaluate pricing rules for a single item request.","operationId":"api_v1_pricing_calculate","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.calculate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/calculate-result":{"post":{"summary":"Calculate Result","description":"Submit a Pricing request to \/pricing\/calculate-result.","operationId":"api_v1_pricing_calculate-result","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.calculate-result","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/cart":{"post":{"summary":"Cart","description":"Submit a Pricing request to \/pricing\/cart.","operationId":"api_v1_pricing_cart","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.cart","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/rules":{"get":{"summary":"Rules","description":"Retrieve Pricing data from \/pricing\/rules.","operationId":"api_v1_pricing_rules","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.rules","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/rules-for-item\/{item}":{"get":{"summary":"Rules For Item","description":"Retrieve Pricing data from \/pricing\/rules-for-item\/{item}.","operationId":"api_v1_pricing_rules-for-item","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.rules-for-item","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"item","in":"path","required":true,"description":"Path parameter: Item","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/pricing\/validate":{"post":{"summary":"Validate","description":"Submit a Pricing request to \/pricing\/validate.","operationId":"api_v1_pricing_validate","tags":["Pricing & Bundles"],"x-route-name":"api.v1.pricing.validate","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns":{"get":{"summary":"List Returns","description":"Get paginated returns scoped by store, warehouse, status, date, and search filters.","operationId":"api_v1_returns_index","tags":["Returns"],"x-route-name":"api.v1.returns.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}},"post":{"summary":"Create Returns","description":"Submit a Returns request to \/returns.","operationId":"api_v1_returns_store","tags":["Returns"],"x-route-name":"api.v1.returns.store","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"sale_id":{"type":"string","description":"Field: Sale Id"},"items":{"type":"array","description":"Field: Items"},"items.*.sale_item_id":{"type":"string","description":"Field: Items * Sale Item Id"},"items.*.quantity":{"type":"integer","description":"Field: Items * Quantity"},"items.*.condition":{"type":"string","description":"Field: Items * Condition"},"items.*.restock":{"type":"boolean","description":"Field: Items * Restock"},"items.*.notes":{"type":"string","description":"Field: Items * Notes"},"items.*.warehouse_id":{"type":"string","description":"Field: Items * Warehouse Id"},"reason_id":{"type":"string","description":"Field: Reason Id"},"reason_notes":{"type":"string","description":"Field: Reason Notes"},"internal_notes":{"type":"string","description":"Field: Internal Notes"},"process_immediately":{"type":"boolean","description":"Field: Process Immediately"},"idempotency_key":{"type":"string","description":"Field: Idempotency Key"}},"required":["sale_id","items","items.*.sale_item_id","items.*.quantity"]},"example":{"sale_id":"example","items":[],"items.*.sale_item_id":"example","items.*.quantity":1,"items.*.condition":"example","items.*.restock":true,"items.*.notes":"example","items.*.warehouse_id":"example","reason_id":"example","reason_notes":"example","internal_notes":"example","process_immediately":true,"idempotency_key":"example"}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/check-sale":{"get":{"summary":"Check Return Eligibility","description":"Validate whether a sale can be returned and return returnable items when eligible.","operationId":"api_v1_returns_check-sale","tags":["Returns"],"x-route-name":"api.v1.returns.check-sale","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/reasons":{"get":{"summary":"List Return Reasons","description":"Return active return reasons for return creation flows.","operationId":"api_v1_returns_reasons","tags":["Returns"],"x-route-name":"api.v1.returns.reasons","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/{saleReturn}":{"get":{"summary":"Get Returns","description":"Retrieve Returns data from \/returns\/{saleReturn}.","operationId":"api_v1_returns_show","tags":["Returns"],"x-route-name":"api.v1.returns.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/{saleReturn}\/approve":{"post":{"summary":"Approve","description":"Submit a Returns request to \/returns\/{saleReturn}\/approve.","operationId":"api_v1_returns_approve","tags":["Returns"],"x-route-name":"api.v1.returns.approve","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/{saleReturn}\/cancel":{"post":{"summary":"Cancel","description":"Submit a Returns request to \/returns\/{saleReturn}\/cancel.","operationId":"api_v1_returns_cancel","tags":["Returns"],"x-route-name":"api.v1.returns.cancel","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/{saleReturn}\/process":{"post":{"summary":"Process","description":"Submit a Returns request to \/returns\/{saleReturn}\/process.","operationId":"api_v1_returns_process","tags":["Returns"],"x-route-name":"api.v1.returns.process","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/returns\/{saleReturn}\/reject":{"post":{"summary":"Reject","description":"Submit a Returns request to \/returns\/{saleReturn}\/reject.","operationId":"api_v1_returns_reject","tags":["Returns"],"x-route-name":"api.v1.returns.reject","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"saleReturn","in":"path","required":true,"description":"Path parameter: Sale Return","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sales":{"get":{"summary":"List Sales","description":"Retrieve Sales data from \/sales.","operationId":"api_v1_sales_index","tags":["Sales"],"x-route-name":"api.v1.sales.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sales\/search":{"get":{"summary":"Search Sales","description":"Retrieve Sales data from \/sales\/search.","operationId":"api_v1_sales_search","tags":["Sales"],"x-route-name":"api.v1.sales.search","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sales\/{sale}":{"get":{"summary":"Get Sales","description":"Retrieve Sales data from \/sales\/{sale}.","operationId":"api_v1_sales_show","tags":["Sales"],"x-route-name":"api.v1.sales.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"sale","in":"path","required":true,"description":"Path parameter: Sale","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sales\/{sale}\/receipt":{"get":{"summary":"Receipt","description":"Retrieve Sales data from \/sales\/{sale}\/receipt.","operationId":"api_v1_sales_receipt","tags":["Sales"],"x-route-name":"api.v1.sales.receipt","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"sale","in":"path","required":true,"description":"Path parameter: Sale","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/current":{"get":{"summary":"Current Cashier Session","description":"Return the open cashier session, if any, for the current user and store.","operationId":"api_v1_sessions_current","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.current","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/open":{"post":{"summary":"Open Cashier Session","description":"Open a new cashier session for the authenticated user.","operationId":"api_v1_sessions_open","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.open","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"store_id":{"type":"integer","description":"Field: Store Id"},"opening_balance":{"type":"number","description":"Field: Opening Balance"},"cash_register_id":{"type":"integer","description":"Field: Cash Register Id"},"notes":{"type":"string","description":"Field: Notes"}},"required":["store_id","opening_balance"]},"example":{"store_id":1,"opening_balance":9.99,"cash_register_id":1,"notes":"example"}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}":{"get":{"summary":"Get Sessions","description":"Retrieve Sessions data from \/sessions\/{session}.","operationId":"api_v1_sessions_show","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}\/cash-movement":{"post":{"summary":"Cash Movement","description":"Submit a Sessions request to \/sessions\/{session}\/cash-movement.","operationId":"api_v1_sessions_cash-movement","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.cash-movement","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Field: Type"},"amount":{"type":"number","description":"Field: Amount"},"reason":{"type":"string","description":"Field: Reason"},"notes":{"type":"string","description":"Field: Notes"},"reference":{"type":"string","description":"Field: Reference"}},"required":["type","amount","reason"]},"example":{"type":"example","amount":9.99,"reason":"example","notes":"example","reference":"example"}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}\/close":{"post":{"summary":"Close","description":"Submit a Sessions request to \/sessions\/{session}\/close.","operationId":"api_v1_sessions_close","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.close","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"closing_balance":{"type":"number","description":"Field: Closing Balance"},"notes":{"type":"string","description":"Field: Notes"},"discrepancy_notes":{"type":"string","description":"Field: Discrepancy Notes"}},"required":["closing_balance"]},"example":{"closing_balance":9.99,"notes":"example","discrepancy_notes":"example"}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}\/resume":{"post":{"summary":"Resume","description":"Submit a Sessions request to \/sessions\/{session}\/resume.","operationId":"api_v1_sessions_resume","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.resume","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}\/summary":{"get":{"summary":"Cashier Session Summary","description":"Return the summary rollup for a cashier session.","operationId":"api_v1_sessions_summary","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.summary","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sessions\/{session}\/suspend":{"post":{"summary":"Suspend","description":"Submit a Sessions request to \/sessions\/{session}\/suspend.","operationId":"api_v1_sessions_suspend","tags":["Cashier Sessions"],"x-route-name":"api.v1.sessions.suspend","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"session","in":"path","required":true,"description":"Path parameter: Session","schema":{"type":"string"}}],"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/stores":{"get":{"summary":"List Accessible Stores","description":"Return stores the authenticated user can access, with optional warehouses and payment methods.","operationId":"api_v1_stores_index","tags":["Products & Catalog"],"x-route-name":"api.v1.stores.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/stores\/{store}":{"get":{"summary":"Get Stores","description":"Retrieve Stores data from \/stores\/{store}.","operationId":"api_v1_stores_show","tags":["Products & Catalog"],"x-route-name":"api.v1.stores.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"store","in":"path","required":true,"description":"Path parameter: Store","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/stores\/{store}\/warehouses":{"get":{"summary":"List Store Warehouses","description":"Return active warehouses for a specific store, optionally including standalone warehouses that serve it.","operationId":"api_v1_stores_warehouses","tags":["Products & Catalog"],"x-route-name":"api.v1.stores.warehouses","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"store","in":"path","required":true,"description":"Path parameter: Store","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sync\/delta":{"get":{"summary":"Delta Offline Sync","description":"Return only records changed since the provided timestamp.","operationId":"api_v1_sync_delta","tags":["Offline Sync"],"x-route-name":"api.v1.sync.delta","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sync\/initial":{"get":{"summary":"Initial Offline Sync","description":"Return the full offline payload needed to bootstrap a device.","operationId":"api_v1_sync_initial","tags":["Offline Sync"],"x-route-name":"api.v1.sync.initial","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sync\/status":{"get":{"summary":"Offline Sync Status","description":"Return sync health, pending uploads, and related status metadata.","operationId":"api_v1_sync_status","tags":["Offline Sync"],"x-route-name":"api.v1.sync.status","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/sync\/upload":{"post":{"summary":"Upload Offline Transactions","description":"Upload offline-created transactions in bulk for server reconciliation.","operationId":"api_v1_sync_upload","tags":["Offline Sync"],"x-route-name":"api.v1.sync.upload","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"store_id":{"type":"integer","description":"Field: Store Id"},"transactions":{"type":"array","description":"Field: Transactions"},"transactions.*.idempotency_key":{"type":"string","description":"Field: Transactions * Idempotency Key"},"transactions.*.type":{"type":"string","description":"Field: Transactions * Type"},"transactions.*.offline_created_at":{"type":"string","description":"Field: Transactions * Offline Created At"},"transactions.*.data":{"type":"array","description":"Field: Transactions * Data"}},"required":["store_id","transactions","transactions.*.idempotency_key","transactions.*.type","transactions.*.data"]},"example":{"store_id":1,"transactions":[],"transactions.*.idempotency_key":"example","transactions.*.type":"example","transactions.*.offline_created_at":"2026-03-16","transactions.*.data":[]}}}},"responses":{"201":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/warehouses":{"get":{"summary":"List Warehouses","description":"Return active warehouses with store and standalone filtering options.","operationId":"api_v1_warehouses_index","tags":["Products & Catalog"],"x-route-name":"api.v1.warehouses.index","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":[{"id":1,"name":"Example"}]}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/warehouses\/standalone":{"get":{"summary":"Standalone","description":"Retrieve Warehouses data from \/warehouses\/standalone.","operationId":"api_v1_warehouses_standalone","tags":["Products & Catalog"],"x-route-name":"api.v1.warehouses.standalone","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}},"\/warehouses\/{warehouse}":{"get":{"summary":"Get Warehouses","description":"Retrieve Warehouses data from \/warehouses\/{warehouse}.","operationId":"api_v1_warehouses_show","tags":["Products & Catalog"],"x-route-name":"api.v1.warehouses.show","x-rate-limit":"60\/minute","security":[{"sanctumBearer":[]}],"parameters":[{"name":"warehouse","in":"path","required":true,"description":"Path parameter: Warehouse","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application\/json":{"example":{"success":true,"data":{"id":1,"name":"Example"}}}}},"401":{"description":"Error response","content":{"application\/json":{"example":{"success":false,"message":"Unauthorized."}}}}}}}},"x-generated-at":"2026-07-03T09:47:53+00:00"}