GET
{micro_service_base_url}
/
stores
/
company
/
{company_id}
/
campaigns
{
  "campaigns": [
    {
      "id": "<string>",
      "name": "<string>",
      "image": "<string>",
      "start_date": "<string>",
      "end_date": "<string>",
      "status": "<string>"
    }
  ],
  "pagination": {
    "total_campaigns": 123,
    "current_page": 123,
    "total_pages": 123,
    "has_next_page": true,
    "has_previous_page": true
  }
}
This endpoint provides comprehensive access to all campaigns associated with a company. It supports pagination, filtering by status, and sorting to efficiently manage large numbers of campaigns.
This endpoint returns essential campaign information optimized for list views and campaign management interfaces. For detailed campaign information, use the Get Campaign Details endpoint.

​
Path Parameters

​
company_id
string
required
The unique identifier of the company whose campaigns you want to retrieve

​
Query Parameters

​
limit
integer
default:"20"
Maximum number of campaigns to return per request (max 100)
​
offset
integer
default:"0"
Number of campaigns to skip for pagination
​
order
string
default:"DESC"
Sort order for campaigns: “ASC” (ascending) or “DESC” (descending)
​
status
string
Filter campaigns by status: “active”, “inactive”, “scheduled”, “expired”
​
search
string
Search campaigns by name or description
​
start_date_from
string
Filter campaigns starting after this date (YYYY-MM-DD)
​
start_date_to
string
Filter campaigns starting before this date (YYYY-MM-DD)

​
Response

​
campaigns
array
Array of campaign objects
​
pagination
object
Pagination information for the response

​
Response Example

[
  {
    "id": "1000007",
    "image": "https://lula-stores-service-staging.s3.amazonaws.com/company/1000058/campaigns/1000007/1741976976661.webp",
    "name": "Summer Essentials Campaign",
    "start_date": "2025-06-01",
    "end_date": "2025-08-31",
    "status": "active"
  },
  {
    "id": "1000008",
    "image": "https://lula-stores-service-staging.s3.amazonaws.com/company/1000058/campaigns/1000008/1741977281470.webp",
    "name": "Back to School Special",
    "start_date": "2025-08-15",
    "end_date": "2025-09-15",
    "status": "scheduled"
  },
  {
    "id": "1000009",
    "image": "https://lula-stores-service-staging.s3.amazonaws.com/company/1000058/campaigns/1000009/1741977365382.webp",
    "name": "Holiday Season Promotions",
    "start_date": "2025-11-01",
    "end_date": "2025-12-31",
    "status": "scheduled"
  },
  {
    "id": "1000010",
    "image": "https://lula-stores-service-staging.s3.amazonaws.com/company/1000058/campaigns/1000010/1744591882710.webp",
    "name": "Spring Fresh Campaign",
    "start_date": "2025-03-01",
    "end_date": "2025-05-31",
    "status": "active"
  }
]
Performance Optimization: Use pagination (limit and offset) when dealing with companies that have many campaigns to ensure fast response times and efficient resource usage.
Search Functionality: The search parameter performs case-insensitive matching against both campaign names and descriptions, making it easy to find specific campaigns.

​
Campaign Status Overview

​
Use Cases

​
Error Responses

Large Result Sets: When requesting campaigns without pagination, large companies may experience slower response times. Always use pagination for production applications.