{"openapi":"3.0.3","info":{"title":"WebKrt Site API","version":"v1","description":"Your business's content and public actions, for your other websites. Send your key as Authorization: Bearer wk_… — create keys in the panel → Developer API.\n\nError codes:\n\n- `missing_key` (401) — No API key was sent.\n- `invalid_key` (401) — The key is not valid.\n- `key_revoked` (401) — This key was revoked in the panel.\n- `key_expired` (401) — The key has expired.\n- `scope_missing` (403) — The key does not have the scope this call needs.\n- `origin_not_allowed` (403) — This site is not allowed to use the key from a browser.\n- `subscription_inactive` (403) — The business subscription is not active.\n- `not_found` (404) — Not found.\n- `method_not_allowed` (405) — This method is not supported on this path.\n- `slot_taken` (409) — The requested time is taken.\n- `invalid_json` (400) — The request body is not valid JSON.\n- `validation_failed` (422) — Missing or invalid data — see `fields`.\n- `rate_limited` (429) — Too many requests — wait the seconds in `Retry-After`.\n- `server_error` (500) — Unexpected error."},"servers":[{"url":"https://webkrt.com/api/site/v1"}],"tags":[{"name":"Business"},{"name":"Services & products"},{"name":"Content"},{"name":"Bookings"},{"name":"Store & orders"},{"name":"Messages & reviews"}],"security":[{"bearerAuth":[]},{"apiKey":[]}],"paths":{"/business":{"get":{"operationId":"business","tags":["Business"],"summary":"Business profile","description":"Name, description, logo, cover, contact details, address, currency, tax and the reviews summary — everything a site header and footer need.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":26,"slug":"nour-clinic","type":"Clinic","type_ar":"عيادة","type_en":"Clinic","name":"Nour Clinic","name_ar":"عيادة نور","name_en":"Nour Clinic","description":"A dermatology and cosmetic clinic in Amman.","description_ar":"عيادة جلدية وتجميل في عمّان.","description_en":"A dermatology and cosmetic clinic in Amman.","bio":"Caring for your skin since 2012","bio_ar":"نهتمّ ببشرتك منذ 2012","bio_en":"Caring for your skin since 2012","logo_url":"https://webkrt.com/uploads/logos/nour.png","cover_url":"https://webkrt.com/uploads/covers/cover-1.jpg","accent_color":"#0f766e","phone":"+962 79 123 4567","whatsapp":"https://wa.me/962791234567","email":"hello@nour.example","website":"https://nour.example","address":"شارع المدينة المنورة","city":"Amman","country":"Jordan","map_url":"https://maps.app.goo.gl/xyz","card_url":"https://webkrt.com/B/nour-clinic","default_language":"ar","languages":["ar","en"],"currency":"JOD","tax":{"enabled":true,"rate":16.0,"prices_include_tax":true},"reviews":{"count":128,"average":4.8}}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hours":{"get":{"operationId":"hours","tags":["Business"],"summary":"Opening hours","description":"The week from Sunday, with opening and closing times (24h), or closed.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"open_now":true,"days":[{"day":6,"day_name":"Saturday","day_name_en":"Saturday","closed":false,"opens":"10:00","closes":"14:00"},{"day":0,"day_name":"Sunday","day_name_en":"Sunday","closed":false,"opens":"09:00","closes":"18:00"},{"day":1,"day_name":"Monday","day_name_en":"Monday","closed":false,"opens":"09:00","closes":"18:00"},{"day":2,"day_name":"Tuesday","day_name_en":"Tuesday","closed":false,"opens":"09:00","closes":"18:00"},{"day":3,"day_name":"Wednesday","day_name_en":"Wednesday","closed":false,"opens":"09:00","closes":"18:00"},{"day":4,"day_name":"Thursday","day_name_en":"Thursday","closed":false,"opens":"09:00","closes":"16:00"},{"day":5,"day_name":"Friday","day_name_en":"Friday","closed":true,"opens":null,"closes":null}]}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/links":{"get":{"operationId":"links","tags":["Business"],"summary":"Links & social accounts","description":"The link buttons on your card and your social accounts.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"links":[{"title":"احجز موعدك","url":"https://example.com/book"}],"social":[{"type":"instagram","value":"https://instagram.com/clinic"},{"type":"whatsapp","value":"962791234567"}]}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services":{"get":{"operationId":"services","tags":["Services & products"],"summary":"Services","description":"Your services with price, duration, category and department. A service is \"bookable\" when it has a price or a duration.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"category_id","in":"query","required":false,"description":"Only one category's services.","schema":{"type":"integer"},"example":3},{"name":"department_id","in":"query","required":false,"description":"Only one department's services.","schema":{"type":"integer"},"example":2},{"name":"q","in":"query","required":false,"description":"Search in the name and description.","schema":{"type":"string"},"example":""},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Items per page (up to 100, default 20).","schema":{"type":"integer"},"example":20}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":12,"name":"Facial cleansing","name_ar":"تنظيف البشرة","name_en":"Facial cleansing","summary":"Deep pore cleansing","summary_ar":"تنظيف عميق للمسام","summary_en":"Deep pore cleansing","image_url":"https://webkrt.com/uploads/services/s-12.jpg","price":25.0,"duration_minutes":45,"bookable":true,"category":{"id":3,"name":"Cosmetic","name_ar":"التجميل","name_en":"Cosmetic"},"department":{"id":2,"name":"Dermatology","name_ar":"الجلدية","name_en":"Dermatology"}}],"meta":{"page":1,"per_page":20,"total":14,"pages":1}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services/{id}":{"get":{"operationId":"service","tags":["Services & products"],"summary":"One service","description":"The whole service, including its formatted content (HTML) in Arabic and English.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"id","in":"path","required":true,"description":"The service id.","schema":{"type":"integer"},"example":12}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":12,"name":"Facial cleansing","name_ar":"تنظيف البشرة","name_en":"Facial cleansing","summary":"Deep pore cleansing","summary_ar":"تنظيف عميق للمسام","summary_en":"Deep pore cleansing","image_url":"https://webkrt.com/uploads/services/s-12.jpg","price":25.0,"duration_minutes":45,"bookable":true,"category":{"id":3,"name":"Cosmetic","name_ar":"التجميل","name_en":"Cosmetic"},"department":{"id":2,"name":"Dermatology","name_ar":"الجلدية","name_en":"Dermatology"},"content_html":"<p>A 45-minute session…</p>","content_html_ar":"<p>جلسة مدتها 45 دقيقة…</p>","content_html_en":"<p>A 45-minute session…</p>"}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/service-categories":{"get":{"operationId":"serviceCategories","tags":["Services & products"],"summary":"Service categories","description":"In the order you set in your panel, with the number of services in each.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":3,"name":"Cosmetic","name_ar":"التجميل","name_en":"Cosmetic","sort":1,"services_count":6}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/departments":{"get":{"operationId":"departments","tags":["Services & products"],"summary":"Departments","description":"Your departments (clinic specialties, company units…) with how many services each has.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":2,"name":"Dermatology","name_ar":"الجلدية","name_en":"Dermatology","services_count":4}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products":{"get":{"operationId":"products","tags":["Services & products"],"summary":"Products","description":"Your store's products with price, availability and category. Prices are for display — an order is always priced on the server.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"category_id","in":"query","required":false,"description":"Only one category's products.","schema":{"type":"integer"},"example":4},{"name":"in_stock","in":"query","required":false,"description":"`true` for available items only.","schema":{"type":"boolean"},"example":true},{"name":"q","in":"query","required":false,"description":"Search in the name and description.","schema":{"type":"string"},"example":""},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Items per page (up to 100, default 20).","schema":{"type":"integer"},"example":20}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":31,"name":"Moisturising cream","name_ar":"كريم مرطّب","name_en":"Moisturising cream","price":12.5,"in_stock":true,"image_url":"https://webkrt.com/uploads/products/p-31.jpg","category":{"id":4,"name":"Skin care","name_ar":"العناية بالبشرة","name_en":"Skin care"}}],"meta":{"page":1,"per_page":20,"total":42,"pages":3}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products/{id}":{"get":{"operationId":"product","tags":["Services & products"],"summary":"One product","description":"The whole product, with its description.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"id","in":"path","required":true,"description":"The product id.","schema":{"type":"integer"},"example":31}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":31,"name":"Moisturising cream","name_ar":"كريم مرطّب","name_en":"Moisturising cream","price":12.5,"in_stock":true,"image_url":"https://webkrt.com/uploads/products/p-31.jpg","category":{"id":4,"name":"Skin care","name_ar":"العناية بالبشرة","name_en":"Skin care"},"description":"For dry skin, 50 ml.","description_ar":"للبشرة الجافة، 50 مل.","description_en":"For dry skin, 50 ml."}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/product-categories":{"get":{"operationId":"productCategories","tags":["Services & products"],"summary":"Product categories","description":"Your store's categories.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":4,"name":"Skin care","name_ar":"العناية بالبشرة","name_en":"Skin care"}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/blog":{"get":{"operationId":"posts","tags":["Content"],"summary":"Blog","description":"Your posts, newest first, each with a short excerpt.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"q","in":"query","required":false,"description":"Search in the name and description.","schema":{"type":"string"},"example":""},{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Items per page (up to 100, default 20).","schema":{"type":"integer"},"example":20}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":7,"title":"Five habits for healthy skin","title_ar":"خمس عادات لبشرة صحية","title_en":"Five habits for healthy skin","excerpt":"Drinking water, sunscreen, enough sleep…","image_url":"https://webkrt.com/uploads/blog/b-7.jpg","published_at":"2026-10-12T09:00:00+03:00"}],"meta":{"page":1,"per_page":20,"total":9,"pages":1}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/blog/{id}":{"get":{"operationId":"post","tags":["Content"],"summary":"One post","description":"The whole post with its formatted content (HTML).\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"id","in":"path","required":true,"description":"The post id.","schema":{"type":"integer"},"example":7}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":7,"title":"Five habits for healthy skin","title_ar":"خمس عادات لبشرة صحية","title_en":"Five habits for healthy skin","excerpt":"Drinking water, sunscreen, enough sleep…","image_url":"https://webkrt.com/uploads/blog/b-7.jpg","published_at":"2026-10-12T09:00:00+03:00","content_html":"<p>Drinking water, sunscreen, enough sleep…</p>","content_html_ar":"<p>شرب الماء، الواقي الشمسي، النوم الكافي…</p>","content_html_en":"<p>Drinking water, sunscreen, enough sleep…</p>"}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/gallery":{"get":{"operationId":"gallery","tags":["Content"],"summary":"Gallery","description":"Your gallery images, newest first.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":18,"image_url":"https://webkrt.com/uploads/gallery/g-18.jpg"}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/certificates":{"get":{"operationId":"certificates","tags":["Content"],"summary":"Certificates","description":"Your certificates and accreditations, newest first.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"title":"البورد الأردني في الجلدية","source":"المجلس الطبي الأردني","details":null,"year":2019}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/brands":{"get":{"operationId":"brands","tags":["Content"],"summary":"Brands","description":"The brands you sell, with how many products each has.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":5,"name":"La Roche-Posay","logo_url":"https://webkrt.com/uploads/brands/lrp.png","products_count":12}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/team":{"get":{"operationId":"team","tags":["Content"],"summary":"Team","description":"The practitioners shown to the public — use one's id to book with them.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":3,"name":"د. ليلى حداد","specialty":"جلدية وتجميل","color":"#0ea5e9"}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reviews":{"get":{"operationId":"reviews","tags":["Content"],"summary":"Reviews","description":"The reviews summary and the latest reviews.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"limit","in":"query","required":false,"description":"How many reviews (up to 50, default 20).","schema":{"type":"integer"},"example":10}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"summary":{"count":128,"average":4.8},"items":[{"name":"سارة","rating":5,"comment":"خدمة ممتازة","created_at":"2026-10-20T18:30:00+03:00"}]}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createReview","tags":["Messages & reviews"],"summary":"Post a review","description":"Published on your page straight away, like reviews on your card.\n\nRequired scope: `reviews:write`","x-scope":"reviews:write","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":4812}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"integer","description":"From 1 to 5."},"name":{"type":"string","description":"Reviewer name."},"comment":{"type":"string","description":"The comment."}},"required":["rating","name"]},"example":{"rating":5,"name":"سارة","comment":"خدمة ممتازة"}}}}}},"/availability":{"get":{"operationId":"availability","tags":["Bookings"],"summary":"Open slots","description":"One day's times from your working hours and practitioners' schedules, with the taken ones marked. When no schedule is set up in your panel the list is empty and `scheduling` = `false` (any time is accepted).\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"date","in":"query","required":true,"description":"The day, `YYYY-MM-DD`.","schema":{"type":"string","format":"date"},"example":"2026-11-02"},{"name":"practitioner_id","in":"query","required":false,"description":"One practitioner's schedule.","schema":{"type":"integer"},"example":3},{"name":"service_id","in":"query","required":false,"description":"To know the service's length.","schema":{"type":"integer"},"example":12}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"date":"2026-11-02","scheduling":true,"slot_minutes":30,"block_taken":true,"slots":[{"time":"09:00","available":true},{"time":"09:30","available":false},{"time":"10:00","available":true}]}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/form-fields":{"get":{"operationId":"formFields","tags":["Bookings"],"summary":"Form fields","description":"Your forms as you set them up in the panel (required/optional/hidden, labels, max length) — so your site's forms match your page's exactly.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[{"name":"form","in":"query","required":false,"description":"`contact`, `booking` or `review` (without it: all three).","schema":{"type":"string"},"example":"booking"}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"booking":{"service_id":{"visible":true,"required":false,"label":"الخدمة","label_ar":null,"label_en":null,"max_length":null,"input_language":"auto"},"name":{"visible":true,"required":true,"label":"الاسم","label_ar":null,"label_en":null,"max_length":150,"input_language":"auto"},"phone":{"visible":true,"required":true,"label":"رقم الجوال","label_ar":"جوالك","label_en":"Mobile","max_length":20,"input_language":"en"}}}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bookings":{"post":{"operationId":"createBooking","tags":["Bookings"],"summary":"Request a booking","description":"The request lands in Appointments in your panel as \"new\", with a notification. Your booking-form settings apply, and a taken time is refused if you asked for that (409).\n\nRequired scope: `bookings:write`","x-scope":"bookings:write","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":4812}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The booker's name (required per your settings)."},"phone":{"type":"string","description":"Phone number."},"date_time":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[ T]\\d{2}:\\d{2}","example":"2026-11-02 10:30","description":"Requested time: `YYYY-MM-DD HH:MM`."},"service_id":{"type":"integer","description":"The service asked for."},"practitioner_id":{"type":"integer","description":"The practitioner asked for."},"note":{"type":"string","description":"Extra details."}}},"example":{"name":"سارة أحمد","phone":"0791234567","date_time":"2026-11-02 10:30","service_id":12,"practitioner_id":3,"note":"أول زيارة"}}}}}},"/delivery-zones":{"get":{"operationId":"zones","tags":["Store & orders"],"summary":"Delivery zones","description":"Active zones with each one's fee and minimum order.\n\nRequired scope: `content:read`","x-scope":"content:read","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":[{"id":2,"name":"Khalda","name_ar":"خلدا","name_en":"Khalda","fee":1.5,"min_order":10.0,"eta_minutes":45}]}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/orders":{"post":{"operationId":"createOrder","tags":["Store & orders"],"summary":"Place an order","description":"The order is priced on the server from your products (send no prices), comes off stock, and appears in Orders with a notification. Keep the `uuid` to follow its status.\n\nRequired scope: `orders:write`","x-scope":"orders:write","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":5521,"uuid":"0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f","status":"new","fulfilment":"delivery","items":[{"product_id":31,"name":"Moisturising cream","name_ar":"كريم مرطّب","name_en":"Moisturising cream","quantity":2,"unit_price":12.5,"total":25.0}],"subtotal":25.0,"delivery_fee":1.5,"tax":3.66,"total":26.5,"currency":"JOD","created_at":"2026-10-25T13:05:00+03:00","tracking_url":"https://webkrt.com/Track/0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f"}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"},"description":"Lines, each: `{\"product_id\": 31, \"quantity\": 2, \"options\": [5]}` (options are optional)."},"name":{"type":"string","description":"Customer name."},"phone":{"type":"string","description":"Phone (or email — at least one)."},"email":{"type":"string","description":"Email."},"fulfilment":{"type":"string","description":"`pickup` (default) or `delivery`."},"zone_id":{"type":"integer","description":"Delivery zone (for delivery)."},"address":{"type":"string","description":"Address (for delivery)."},"notes":{"type":"string","description":"Order notes."}},"required":["items","name"]},"example":{"items":[{"product_id":31,"quantity":2}],"name":"عمر خليل","phone":"0791234567","email":"omar@example.com","fulfilment":"delivery","zone_id":2,"address":"عمّان — خلدا","notes":"بدون بصل"}}}}}},"/orders/{uuid}":{"get":{"operationId":"order","tags":["Store & orders"],"summary":"Order status","description":"One order by the `uuid` returned when it was placed — status, lines, amounts and the tracking link.\n\nRequired scope: `orders:write`","x-scope":"orders:write","parameters":[{"name":"uuid","in":"path","required":true,"description":"The id returned when the order was placed.","schema":{"type":"string"},"example":"0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f"}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":5521,"uuid":"0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f","status":"new","fulfilment":"delivery","items":[{"product_id":31,"name":"Moisturising cream","name_ar":"كريم مرطّب","name_en":"Moisturising cream","quantity":2,"unit_price":12.5,"total":25.0}],"subtotal":25.0,"delivery_fee":1.5,"tax":3.66,"total":26.5,"currency":"JOD","created_at":"2026-10-25T13:05:00+03:00","tracking_url":"https://webkrt.com/Track/0f8c1c9e-2b7a-4c1e-9d2f-5a6b7c8d9e0f"}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inquiries":{"post":{"operationId":"createInquiry","tags":["Messages & reviews"],"summary":"Send a message","description":"Lands in Inquiries in your panel, with a notification. Your contact-form settings apply.\n\nRequired scope: `inquiries:write`","x-scope":"inquiries:write","parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"ok":true,"data":{"id":4812}}}}},"default":{"description":"Error — see error.code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Sender name."},"phone":{"type":"string","description":"Phone."},"email":{"type":"string","description":"Email."},"subject":{"type":"string","description":"Subject."},"message":{"type":"string","description":"The message (required per your settings)."}},"required":["name"]},"example":{"name":"ليلى","phone":"0791234567","email":"laila@example.com","subject":"استفسار عن الأسعار","message":"هل تعملون يوم الجمعة؟"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"wk_<prefix>_<secret>"},"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Error":{"type":"object","properties":{"ok":{"type":"boolean","example":false},"error":{"type":"object","properties":{"code":{"type":"string","example":"validation_failed"},"message":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":"string"}}}}}}}}}