Skip to main content
PUT
/
stores
/
{store_id}
/
status
Change Store Status
curl --request PUT \
  --url https://api-staging.luladelivery.store/stores/{store_id}/status
{
  "success": true,
  "status": {
    "current_pause": "<string>",
    "is_close": true,
    "UberEats": [
      {}
    ],
    "DoorDash": [
      {}
    ],
    "GrubHub": [
      {}
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
store_id
string
required
The unique identifier of the store to update status for
​
dsp_name
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
​
is_active
boolean
required
Store operational status:
  • true - Opens the store (ONLINE)
  • false - Closes the store (OFFLINE)
​
end_time
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
​
start_time
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

​
success
boolean
Indicates whether the status change was successful
​
status
object
Detailed status information after the change (included for “All” operations)

​
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

​
Coordinated Operations
best-practice
Use “All” for consistent customer experience across platforms
Customers expect consistent availability across all delivery apps
​
Platform-Specific Issues
best-practice
Use individual platform controls when specific integrations have issues
This allows you to maintain operations on working platforms
​
Scheduled Changes
best-practice
Use end_time for temporary closures (breaks, maintenance, etc.)
Without end_time, status changes are permanent
​
Emergency Closure
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.