Skip to main content
GET
/
stores
/
company
Get Company Details
curl --request GET \
  --url https://api-staging.luladelivery.store/stores/company
{
  "totalStoresCount": 123,
  "totalCompaniesCount": 123,
  "companies": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "<string>",
      "point_of_contact": "<string>",
      "addresses": {
        "id": "<string>",
        "line_1": "<string>",
        "line_2": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "state": "<string>",
        "country": "<string>"
      },
      "stores": {
        "stores_count": "<string>"
      }
    }
  ]
}
This endpoint provides comprehensive company information including business details, address, operational status, and the number of associated stores. It supports both retrieving all companies and fetching specific company details.

​
Get All Companies

Retrieves a list of all companies in the system with summary information including total counts.

​
Query Parameters

​
company_id
string
Specific company ID to retrieve details for a single company. If not provided, returns all companies.

​
Response - All Companies

​
totalStoresCount
number
Total number of stores across all companies
​
totalCompaniesCount
number
Total number of companies in the system
​
companies
array
Array of company objects

​
Get Specific Company

When a company_id is provided, returns detailed information for that specific company.

​
Response - Single Company

Returns an array with a single company object containing the same structure as described above.

​
Response Examples

​
All Companies Response

{
    "totalStoresCount": 12,
    "totalCompaniesCount": 16,
    "companies": [
        {
            "id": "1000008",
            "name": "Lula Demo Company\n",
            "status": null,
            "point_of_contact": null,
            "addresses": {
                "id": "8b9ab17c-5dbb-4080-8719-a3a2e9226584",
                "line_1": "3230 Market Street",
                "line_2": null,
                "city": "Philadelphia",
                "zip": "19104",
                "state": "PA",
                "country": null
            },
            "stores": {
                "stores_count": "1"
            }
        },
        {
            "id": "1000016",
            "name": "Salman's Company",
            "status": "On Boarding",
            "point_of_contact": null,
            "addresses": {
                "id": "44cf546d-3deb-459c-883d-ceb47e94451a",
                "line_1": "39 Block Q, Phase 2 Johar Town",
                "line_2": null,
                "city": "Lahore",
                "zip": "54782",
                "state": "Punjab",
                "country": null
            },
            "stores": {
                "stores_count": "1"
            }
        }
    ]
}

​
Single Company Response

[
    {
        "id": "1000022",
        "name": "Salman's Company",
        "status": "On Boarding",
        "point_of_contact": "lula delivery",
        "addresses": {
            "id": "1359b612-3f09-430b-9bf1-5fc1460c8535",
            "line_1": "39 Block Q, Phase 2 Johar Town",
            "line_2": null,
            "city": "Lahore",
            "zip": "54782",
            "state": "Punjab",
            "country": null
        },
        "stores": {
            "stores_count": "7"
        }
    }
]
Usage Tips:
  • Use without parameters to get an overview of all companies and their store counts
  • Include company_id parameter to get detailed information for a specific company
  • The stores_count field helps you understand the scale of each company’s operations
  • point_of_contact field may be null if no contact person is assigned
Some companies may have null values for status or point_of_contact fields. Always check for null values when processing the response.