Change Store Status

curl --request PUT \
  --url https://api-staging.luladelivery.store/stores/{store_id}/status

const options = {method: 'PUT'};

fetch('https://api-staging.luladelivery.store/stores/{store_id}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.luladelivery.store/stores/{store_id}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.luladelivery.store/stores/{store_id}/status"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-staging.luladelivery.store/stores/{store_id}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": {
    "current_pause": "<string>",
    "is_close": true,
    "UberEats": [
      {}
    ],
    "DoorDash": [
      {}
    ],
    "GrubHub": [
      {}
    ]
  }
}

PUT

stores

{store_id}

status

Change Store Status

curl --request PUT \
  --url https://api-staging.luladelivery.store/stores/{store_id}/status

const options = {method: 'PUT'};

fetch('https://api-staging.luladelivery.store/stores/{store_id}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-staging.luladelivery.store/stores/{store_id}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-staging.luladelivery.store/stores/{store_id}/status"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-staging.luladelivery.store/stores/{store_id}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "status": {
    "current_pause": "<string>",
    "is_close": true,
    "UberEats": [
      {}
    ],
    "DoorDash": [
      {}
    ],
    "GrubHub": [
      {}
    ]
  }
}

This endpoint provides granular control over store availability across delivery platforms. You can manage store status globally or per platform, with optional scheduling for automatic status changes.

Path Parameters

string

required

The unique identifier of the store to update status for

Request Body Fields

string

required

Delivery Service Provider to control. Options:

"All" - Controls all platforms simultaneously
"UberEats" - Controls only UberEats
"DoorDash" - Controls only DoorDash
"GrubHub" - Controls only GrubHub

boolean

required

Store operational status:

true - Opens the store (ONLINE)
false - Closes the store (OFFLINE)

string

When the status change should automatically revert. ISO 8601 format with timezone.Example: “2024-11-15T23:59:00-07:00”

If omitted, the status change is permanent until manually changed

string

When the status change should take effect (for scheduled changes).Example: “2024-11-15T00:00:00-05:00”

Used primarily for scheduling future status changes

Common Operations

Open All Platforms

Opens the store on all delivery platforms simultaneously.

{
    "dsp_name": "All",
    "is_active": true,
    "end_time": "2024-11-15T23:59:00-07:00"
}

Close All Platforms

Closes the store on all delivery platforms simultaneously.

{
    "dsp_name": "All",
    "is_active": false
}

Platform-Specific Control

Open UberEats Only

{
    "dsp_name": "UberEats",
    "is_active": true,
    "end_time": "2024-11-15T23:59:00-07:00"
}

Close DoorDash Only

{
    "dsp_name": "DoorDash",
    "is_active": false,
    "end_time": "2024-11-15T23:59:00-07:00"
}

Pause GrubHub

{
    "dsp_name": "GrubHub",
    "is_active": false,
    "end_time": "2024-06-21T17:08:30.000Z"
}

Scheduled Operations

Schedule Store Pause

{
    "dsp_name": "All",
    "is_active": false,
    "end_time": "2024-11-15T23:59:00-05:00",
    "start_time": "2024-11-15T00:00:00-05:00"
}

Response Types

Successful Status Change

boolean

Indicates whether the status change was successful

object

Detailed status information after the change (included for “All” operations)

Show Status Object

string

Any current pause affecting all platforms

boolean

Overall store closure status

array

UberEats status after change

array

DoorDash status after change

array

GrubHub status after change

Simple Success Response

For single platform operations or basic operations:

{
    "success": true
}

Detailed Response Example

For “All” platform operations with full status:

{
    "success": true,
    "status": {
        "current_pause": null,
        "is_close": false,
        "UberEats": [
            {
                "success": true,
                "is_open": true,
                "status": "ONLINE",
                "end_time": null,
                "current_pause": null,
                "description": [
                    {
                        "status": "ONLINE"
                    }
                ],
                "id": "37fa9980-33ba-4419-92c2-a6e5144fdc82",
                "partner_store_id": "15be0357-9b4d-4f05-9a5a-9485b5f783e5",
                "name": "Lula Convenience Store",
                "status_changed_from": true
            }
        ],
        "DoorDash": [
            {
                "success": true,
                "is_open": true,
                "status": "ONLINE",
                "end_time": null,
                "current_pause": null,
                "description": [],
                "id": "1704fecd-e6ca-45bb-b1b5-776aee294af8",
                "partner_store_id": "b1015bdb-e831-42ef-b6f8-720fab19321f",
                "name": "Lula Convenience Store",
                "status_changed_from": true
            }
        ],
        "GrubHub": [
            {
                "success": true,
                "is_open": true,
                "status": "ONLINE",
                "end_time": null,
                "current_pause": null,
                "description": [
                    {
                        "merchant_status": "PT_PREMIUM",
                        "merchant_status_descriptor": "Premium",
                        "pos_merchant_status": "online",
                        "holds_active_account": true,
                        "accepting_phone_orders": true,
                        "accepting_online_orders": true
                    }
                ],
                "id": "d0b3e829-299f-42cc-a768-2f9a908f3355",
                "partner_store_id": "1240569280",
                "name": "Lula Convenience Store",
                "status_changed_from": true
            }
        ]
    }
}

Best Practices

Status Management Recommendations

best-practice

Use “All” for consistent customer experience across platforms

Customers expect consistent availability across all delivery apps

best-practice

Use individual platform controls when specific integrations have issues

This allows you to maintain operations on working platforms

best-practice

Use end_time for temporary closures (breaks, maintenance, etc.)

Without end_time, status changes are permanent

best-practice

For immediate closures, use “All” with is_active: false

This immediately stops new orders across all platforms

Real-time Effect: Status changes take effect immediately on all specified platforms. Existing orders in progress are not affected.

Timezone Awareness: When using end_time, ensure the timezone offset matches the store’s local timezone to avoid unexpected behavior.

Platform Dependencies: Some platforms may have additional requirements or delays in reflecting status changes. The response indicates the success of the API call, not necessarily the immediate platform reflection.

API Documentation - Legacy

API Documentation - Latest

Change Store Status

Path Parameters

Common Operations

Open All Platforms

Close All Platforms

Platform-Specific Control

Open UberEats Only

Close DoorDash Only

Pause GrubHub

Scheduled Operations

Schedule Store Pause

Response Types

Successful Status Change

Simple Success Response

Detailed Response Example

Best Practices

​Path Parameters

​Common Operations

​Open All Platforms

​Close All Platforms

​Platform-Specific Control

​Open UberEats Only

​Close DoorDash Only

​Pause GrubHub

​Scheduled Operations

​Schedule Store Pause

​Response Types

​Successful Status Change

​Simple Success Response

​Detailed Response Example

​Best Practices

Path Parameters

Common Operations

Open All Platforms

Close All Platforms

Platform-Specific Control

Open UberEats Only

Close DoorDash Only

Pause GrubHub

Scheduled Operations

Schedule Store Pause

Response Types

Successful Status Change

Simple Success Response

Detailed Response Example

Best Practices