Branch
Create Branch
Create a new branch for a market.
Authorization
default AuthorizationBearer <token>
You can retrieve your token by logging in.
In: header
Header Parameters
X-API-Version*string
API contract version to target. See the Changelog for what changed in each version.
Default
"2.0.0"Value in
"2.3.0" | "2.2.0" | "2.1.0" | "2.0.0"Request Body
application/json
includes*array<>
market_id*string
Market ID. The id of an existing record in the markets table.
name_en*string
English name. Must not be greater than 191 characters.
name_ar?|
Arabic name. Must not be greater than 191 characters.
address*string
Branch address. Must not be greater than 500 characters.
latitude*number
Geographic latitude. Must be between -90 and 90.
longitude*number
Geographic longitude. Must be between -180 and 180.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "http://localhost:8000/api/v2/branches" \ -H "X-API-Version: 2.3.0" \ -H "Content-Type: application/json" \ -d '{ "includes": [ "debitis" ], "market_id": "uuid", "name_en": "Downtown Branch", "address": "123 Main Street, Riyadh", "latitude": 24.7136, "longitude": 46.6753 }'{
"meta": {
"code": 200,
"status": "success",
"message": "Branch created successfully."
},
"data": {
"id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"name_en": "Christiansen-Gerhold",
"name_ar": "Christiansen-Gerhold",
"address": "54013 Verona Lakes Apt. 398\nHaagview, CT 10785-9746",
"latitude": 28.09509,
"longitude": -144.445445,
"is_active": false,
"created_at": 1782824834448,
"updated_at": 1782824834448,
"deleted_at": null,
"expired_at": null,
"is_online": false,
"level": null,
"shift": {
"day": "TUE",
"min": 1782777600000,
"max": 1782863999000,
"open_at": 1782777000000,
"lock_at": 1782867599000
},
"days": {
"SUN": 1,
"MON": 1,
"TUE": 1,
"WED": 1,
"THU": 1,
"FRI": 1,
"SAT": 1
},
"location": null,
"plans": [],
"schedules": [
{
"id": 8,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "SUN",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 9,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "MON",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 10,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "TUE",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 11,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "WED",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 12,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "THU",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 13,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "FRI",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
},
{
"id": 14,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"day": "SAT",
"start_time": "00:00:00",
"close_time": "23:59:59",
"created_at": 1782824834448,
"updated_at": 1782824834448,
"open_type": null,
"open_value": null,
"lock_type": null,
"lock_value": null,
"end_time": "23:59:59"
}
],
"out_of_stock_products": [],
"waiting_orders": [],
"process_orders": [],
"canceled_orders": [],
"completed_orders": [],
"market": {
"id": "07928d80-350c-46eb-8786-91a40ca509a0",
"sector_id": 13,
"name_en": "Donnelly-Swaniawski",
"name_ar": "Donnelly-Swaniawski",
"description_en": null,
"description_ar": null,
"logo_img": "https://via.placeholder.com/200x200.png/00ffff?text=business+logo+et",
"cover_img": "https://via.placeholder.com/200x200.png/00ee66?text=business+cover+animi",
"email": "[email protected]",
"phone_prefix": "212",
"phone_number": "4769320137",
"crn": "124-313-2863",
"tax_number": "72043015227",
"created_by": null,
"email_verified_at": 1782824824410,
"phone_verified_at": 1782824824410,
"created_at": 1782824824152,
"updated_at": 1782824824152,
"deleted_at": null,
"is_active": true,
"merchant_id": null,
"reseller_id": null,
"slug": "donnelly-swaniawski",
"code": "ENT-0000000001",
"links": {
"website": null,
"instagram": null,
"youtube": null,
"x": null,
"call_center": null
},
"phone": "4769320137",
"setting": null
},
"setting": {
"id": 2,
"market_id": "07928d80-350c-46eb-8786-91a40ca509a0",
"branch_id": "dfe515e6-5320-4b27-a9be-82bcae4d431b",
"is_kitchen_active": true,
"is_pay_later": false,
"invoice_prefix": null,
"zatca_otp": null,
"extension": {
"has_cleartax": false,
"has_zatca": false,
"has_qoyod": false
},
"payment": {
"has_apple": true,
"has_card": true,
"has_cash": true
},
"service": {
"has_dining": true,
"has_take_away": true
},
"active_plan": null,
"active_subscription": null
}
}
}{
"meta": {
"code": 401,
"status": "error",
"message": "Unauthenticated."
},
"data": null
}{
"meta": {
"code": 403,
"status": "error",
"message": "Unauthorized."
},
"data": null
}{
"meta": {
"code": 404,
"status": "error",
"message": "Resource not found."
},
"data": null
}{
"meta": {
"code": 422,
"status": "error",
"message": "The selected market id is invalid. (and 4 more errors)"
},
"data": [
{
"code": 0,
"message": "The selected market is invalid.",
"field": "market"
},
{
"code": 0,
"message": "The name en must be a string.",
"field": "name_en"
},
{
"code": 0,
"message": "The address field is required.",
"field": "address"
},
{
"code": 0,
"message": "The latitude must be a number.",
"field": "latitude"
},
{
"code": 0,
"message": "The longitude must be a number.",
"field": "longitude"
}
]
}{
"meta": {
"code": 500,
"status": "error",
"message": "Internal server error."
},
"data": null
}