GET
{stores_service_api_base_url}
/
stores
/
company
/
{company_id}
/
campaigns
/
{campaign_id}
/
stores
{
  "campaign_id": "<string>",
  "campaign_name": "<string>",
  "total_associated_stores": 123,
  "store_associations": [
    {
      "store_id": "<string>",
      "store_name": "<string>",
      "store_type": "<string>",
      "region": "<string>",
      "association_status": "<string>",
      "linked_at": "<string>",
      "last_updated": "<string>",
      "store_specific_config": {
        "custom_messaging": "<string>",
        "local_promotions": [
          {}
        ],
        "display_settings": {},
        "scheduling_overrides": {}
      }
    }
  ],
  "association_summary": {
    "by_status": {},
    "by_store_type": {},
    "by_region": {},
    "performance_overview": {}
  }
}
This endpoint manages the relationship between campaigns and store locations, allowing you to see which stores are associated with a campaign and manage store-specific campaign configurations.
Campaign-store associations determine where campaigns are active and visible to customers. Each association can have store-specific settings and configurations.

​
Path Parameters

​
company_id
string
required
The unique identifier of the company that owns the campaign
​
campaign_id
string
required
The unique identifier of the campaign to retrieve store associations for

​
Query Parameters

​
status
string
Filter associations by status: “active”, “inactive”, “pending”
​
store_type
string
Filter by store type: “retail”, “online”, “franchise”, “corporate”
​
region
string
Filter stores by geographical region
​
include_config
boolean
default:"false"
Include store-specific campaign configurations in the response

​
Response

​
campaign_id
string
The campaign identifier
​
campaign_name
string
Name of the campaign
​
total_associated_stores
integer
Total number of stores associated with this campaign
​
store_associations
array
Array of store association details
​
association_summary
object
Summary statistics for campaign-store associations

​
Response Example

{
  "campaign_id": "1000010",
  "campaign_name": "Spring Fresh Campaign",
  "total_associated_stores": 15,
  "store_associations": [
    {
      "store_id": "store_001",
      "store_name": "Downtown Location",
      "store_type": "retail",
      "region": "Northeast",
      "association_status": "active",
      "linked_at": "2025-04-14T01:00:00.000Z",
      "last_updated": "2025-04-14T01:00:00.000Z",
      "store_specific_config": {
        "custom_messaging": "Spring Fresh - Now Available Downtown!",
        "local_promotions": ["LOCAL10", "DOWNTOWN15"],
        "display_settings": {
          "banner_position": "header",
          "highlight_color": "#00FF00"
        },
        "scheduling_overrides": {
          "extended_hours": true,
          "weekend_only": false
        }
      }
    },
    {
      "store_id": "store_002",
      "store_name": "Mall Location",
      "store_type": "retail",
      "region": "Northeast",
      "association_status": "active",
      "linked_at": "2025-04-14T01:15:00.000Z",
      "last_updated": "2025-04-14T01:15:00.000Z"
    }
  ],
  "association_summary": {
    "by_status": {
      "active": 12,
      "inactive": 2,
      "pending": 1
    },
    "by_store_type": {
      "retail": 10,
      "online": 3,
      "franchise": 2
    },
    "by_region": {
      "Northeast": 8,
      "Southeast": 4,
      "West": 3
    },
    "performance_overview": {
      "total_campaign_views": 5420,
      "total_conversions": 324,
      "average_conversion_rate": 5.97
    }
  }
}
Store-Specific Configurations: Each store can have unique campaign settings while maintaining the overall campaign structure. This allows for localized marketing while maintaining brand consistency.
Performance Tracking: Use the association summary data to identify which store types or regions are performing best with the campaign, helping optimize future campaign targeting.

​
Use Cases

​
Error Responses

Privacy Considerations: Store association data may include sensitive business information about store performance and configurations. Ensure appropriate access controls are in place.

​
Managing Associations