> For the complete documentation index, see [llms.txt](https://developers.gleantap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gleantap.com/fetch-data/campaigns.md).

# Campaigns

## Get campaigns list

> Retrieve list of campaigns with optional filters

```json
{"openapi":"3.0.0","info":{"title":"Gleantap External API","version":"1.0.0"},"tags":[{"name":"Campaigns","description":"Campaigns"}],"servers":[{"url":"https://api.gleantap.com","description":"Production server"}],"paths":{"/v2/ExternalApi/getCampaigns":{"post":{"tags":["Campaigns"],"summary":"Get campaigns list","description":"Retrieve list of campaigns with optional filters","operationId":"bb698408d05f7ba4f7f9bed138f71067","parameters":[{"name":"X-API-KEY","in":"header","description":"Your API key","required":true,"schema":{"type":"string"}},{"name":"X-SECRET-KEY","in":"header","description":"Your Secret key","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["app_id"],"properties":{"app_id":{"type":"string"},"campaign_id":{"type":"string"},"updated_since":{"type":"string","format":"date"},"created_since":{"type":"string","format":"date"},"limit":{"type":"integer","maximum":1000},"offset":{"type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Campaigns retrieved successfully","content":{"application/json":{"schema":{"properties":{"campaigns":{"type":"array","items":{"properties":{"id":{"type":"string"},"campaign_name":{"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"schedule":{"type":"string"},"created_by":{"type":"string"},"created_on":{"type":"string","format":"date"},"subject":{"type":"string"},"sent":{"type":"integer"},"opened":{"type":"integer"},"clicked":{"type":"integer"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Invalid request"}}}}}}
```