GET
/
stores
/
company
/
{company_id}
/
onboarding
Get Onboarding by Company ID
curl --request GET \
  --url https://api-staging.luladelivery.store/stores/company/{company_id}/onboarding
{
  "company_id": "<string>",
  "total_stores": 123,
  "onboarded_stores": 123,
  "pending_onboarding": 123,
  "stores": [
    {
      "store_id": "<string>",
      "store_name": "<string>",
      "onboarding_status": "<string>",
      "created_at": "<string>",
      "onboarded_at": "<string>",
      "current_status": {
        "is_operational": true,
        "platforms_online": 123,
        "platforms_total": 123,
        "last_status_check": "<string>"
      },
      "platform_details": {
        "UberEats": {
          "is_active": true,
          "status": "<string>",
          "partner_store_id": "<string>",
          "last_updated": "<string>"
        },
        "DoorDash": {},
        "GrubHub": {}
      }
    }
  ]
}
This endpoint provides a comprehensive overview of onboarding status for all stores under a company. It’s useful for company-level monitoring and management of store operations across multiple locations.

Path Parameters

company_id
string
required
The unique identifier of the company to retrieve onboarding information for all its stores

Response

company_id
string
The company ID for which onboarding information was retrieved
total_stores
number
Total number of stores belonging to this company
onboarded_stores
number
Number of stores that have completed onboarding
pending_onboarding
number
Number of stores with onboarding in progress or pending
stores
array
Array of store onboarding information

Response Example

{
    "company_id": "1000022",
    "total_stores": 5,
    "onboarded_stores": 3,
    "pending_onboarding": 2,
    "stores": [
        {
            "store_id": "7669f473-6c40-45ee-8737-43c667407b3a",
            "store_name": "Lula Convenience Store - Main",
            "onboarding_status": "completed",
            "created_at": "2023-09-20T13:27:11.318Z",
            "onboarded_at": "2023-09-20T14:15:22.456Z",
            "current_status": {
                "is_operational": true,
                "platforms_online": 2,
                "platforms_total": 3,
                "last_status_check": "2024-11-15T03:46:34.000Z"
            },
            "platform_details": {
                "UberEats": {
                    "is_active": true,
                    "status": "ONLINE",
                    "partner_store_id": "15be0357-9b4d-4f05-9a5a-9485b5f783e5",
                    "last_updated": "2024-11-15T03:30:00.000Z"
                },
                "DoorDash": {
                    "is_active": true,
                    "status": "ONLINE",
                    "partner_store_id": "b1015bdb-e831-42ef-b6f8-720fab19321f",
                    "last_updated": "2024-11-15T03:30:00.000Z"
                },
                "GrubHub": {
                    "is_active": false,
                    "status": "OFFLINE",
                    "partner_store_id": "1240569280",
                    "last_updated": "2024-11-15T02:15:00.000Z"
                }
            }
        },
        {
            "store_id": "8669f473-6c40-45ee-8737-43c667407b3b",
            "store_name": "Lula Convenience Store - Branch",
            "onboarding_status": "in_progress",
            "created_at": "2023-09-21T10:15:30.123Z",
            "onboarded_at": null,
            "current_status": {
                "is_operational": false,
                "platforms_online": 0,
                "platforms_total": 3,
                "last_status_check": "2024-11-15T03:46:34.000Z"
            },
            "platform_details": {
                "UberEats": {
                    "is_active": false,
                    "status": "SETUP_PENDING",
                    "partner_store_id": null,
                    "last_updated": "2023-09-21T10:15:30.123Z"
                },
                "DoorDash": {
                    "is_active": false,
                    "status": "SETUP_PENDING",
                    "partner_store_id": null,
                    "last_updated": "2023-09-21T10:15:30.123Z"
                },
                "GrubHub": {
                    "is_active": false,
                    "status": "SETUP_PENDING",
                    "partner_store_id": null,
                    "last_updated": "2023-09-21T10:15:30.123Z"
                }
            }
        }
    ]
}

Company-Level Insights

Use Cases

Filtering and Analysis

Data Freshness: Company-level onboarding data is updated in real-time as individual store statuses change, providing current operational insights.
Scalability: This endpoint efficiently handles companies with large numbers of stores, making it suitable for enterprise-level operations monitoring.