--- updatedAt: 2026-04-21T14:15:01.000Z agentTools: projectIndex: https://marketing.developer.dotdigital.com/llms.txt --- # Get campaigns sent to address book or segment Gets any campaigns that have been sent to an address book or a segment # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Lists / Address books", "version": "2.0.2", "description": "Manage contact lists (address books) and their memberships. Use this API to create, update, and delete lists; retrieve all, public, or private lists; bulk-import contacts; remove individual or multiple contacts; manage subscription status (unsubscribe and resubscribe); and query contacts within a list by preference opt-in status or unsubscribe date.\n" }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true, "x-samples-languages": [ "curl", "csharp", "java", "javascript", "node", "python", "php", "ruby" ], "externalDocs": { "description": "Learn more about Dotdigital APIs", "url": "https://developer.dotdigital.com" }, "servers": [ { "url": "https://{region}-api.dotdigital.com", "variables": { "region": { "default": "r1", "enum": [ "r1", "r2", "r3" ], "description": "The Dotdigital region id your account belongs to" } } } ], "security": [ { "basicAuth": [] } ], "components": { "securitySchemes": { "basicAuth": { "type": "http", "scheme": "basic" } } }, "paths": { "/v2/address-books/{id}/campaigns": { "parameters": [ { "in": "header", "name": "x-ddg-integration-token", "required": false, "description": "If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.", "schema": { "type": "string", "pattern": "/^(?:\\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\\}{0,1})$/", "example": "5a96bc79-19a7-4544-973b-e2da0c9136f9" } } ], "get": { "summary": "Get campaigns sent to address book or segment", "deprecated": false, "description": "Gets any campaigns that have been sent to an address book or a segment", "operationId": "get-campaigns-sent-to-address-book-or-segment", "tags": [ "Lists / Address books" ], "parameters": [ { "name": "id", "in": "path", "description": "The ID of the address book or segment", "required": true, "example": 0, "schema": { "type": "integer", "format": "int32" } }, { "name": "select", "in": "query", "description": "he select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request. This parameter goes within the URL.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "skip", "in": "query", "description": "The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set.", "required": false, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "default": 0, "examples": [ 1 ] }, "name": { "type": "string", "examples": [ "Monthly newsletter Dec 2015" ] }, "subject": { "type": "string", "examples": [ "Monthly newsletter" ] }, "fromName": { "type": "string", "examples": [ "Company name" ] }, "fromAddress": { "type": "object", "properties": { "id": { "type": "integer", "default": 0, "examples": [ 1 ] }, "email": { "type": "string", "examples": [ "demo@apiconnector.com" ] } } }, "htmlContent": {}, "plainTextContent": {}, "replyAction": { "type": "string", "examples": [ "Unset" ] }, "replyToAddress": {}, "isSplitTest": { "type": "boolean", "default": true, "examples": [ false ] }, "status": { "type": "string", "examples": [ "Sent" ] } } } }, "examples": { "Result": { "summary": "Result", "value": [ { "id": 1, "name": "Monthly newsletter Dec 2015", "subject": "Monthly newsletter", "fromName": "Company name", "fromAddress": { "id": 1, "email": "demo@apiconnector.com" }, "htmlContent": null, "plainTextContent": null, "replyAction": "Unset", "replyToAddress": null, "isSplitTest": false, "status": "Sent" }, { "id": 4, "name": "New product promotion", "subject": "New product!", "fromName": "Company name", "fromAddress": { "id": 1, "email": "demo@apiconnector.com" }, "htmlContent": null, "plainTextContent": null, "replyAction": "WebMailForward", "replyToAddress": "demo@apiconnector.com", "isSplitTest": false, "status": "Sent" } ] } } } } } } } } } } ``` # Sibling pages * [Get all campaigns (with filters)](https://marketing.developer.dotdigital.com/reference/get-all-campaigns-with-filters.md) * [Get campaigns with activity since date](https://marketing.developer.dotdigital.com/reference/get-campaigns-with-activity-since-date.md) * [Get campaign with details](https://marketing.developer.dotdigital.com/reference/get-campaign-with-details.md) * [Create campaign](https://marketing.developer.dotdigital.com/reference/create-campaign.md) * [Create split test campaign](https://marketing.developer.dotdigital.com/reference/create-split-test-campaign.md) * [Update campaign](https://marketing.developer.dotdigital.com/reference/update-campaign.md) * [Delete campaign](https://marketing.developer.dotdigital.com/reference/delete-campaign.md) * [Copy campaign](https://marketing.developer.dotdigital.com/reference/copy-campaign.md) * [Send campaign](https://marketing.developer.dotdigital.com/reference/send-campaign.md) * [Send time optimised campaign](https://marketing.developer.dotdigital.com/reference/send-time-optimised-campaign.md) * [Get campaign send status](https://marketing.developer.dotdigital.com/reference/get-campaign-send-status.md) * [Add campaign attachment](https://marketing.developer.dotdigital.com/reference/add-campaign-attachment.md) * [Get campaign attachments](https://marketing.developer.dotdigital.com/reference/get-campaign-attachments.md) * [Remove campaign attachment](https://marketing.developer.dotdigital.com/reference/remove-campaign-attachment.md) * [Gets sent campaigns metrics between the specified dates.](https://marketing.developer.dotdigital.com/reference/getdailycampaignmetrics.md) * [Get campaign summary](https://marketing.developer.dotdigital.com/reference/get-campaign-summary.md) * [Get campaign opens](https://marketing.developer.dotdigital.com/reference/get-campaign-opens.md) * [Get campaign opens for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-opens-for-a-contact.md) * [Get campaign activity for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-activity-for-a-contact.md) * [Get campaign activity since date](https://marketing.developer.dotdigital.com/reference/get-campaign-activity-since-date.md) * [Get campaign clicks](https://marketing.developer.dotdigital.com/reference/get-campaign-clicks.md) * [Get campaign clicks and link groups](https://marketing.developer.dotdigital.com/reference/get-campaign-clicks-and-link-groups.md) * [Get campaign clicks since date](https://marketing.developer.dotdigital.com/reference/get-campaign-clicks-since-date.md) * [Get campaign clicks and link groups since date](https://marketing.developer.dotdigital.com/reference/get-campaign-clicks-and-link-groups-since-date.md) * [Get campaign opens since date](https://marketing.developer.dotdigital.com/reference/get-campaign-opens-since-date.md) * [Get campaign activity](https://marketing.developer.dotdigital.com/reference/get-campaign-activity.md) * [Get campaign address books](https://marketing.developer.dotdigital.com/reference/get-campaign-address-books.md) * [Get campaign clicks for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-clicks-for-a-contact.md) * [Get campaign contact clicks and link groups](https://marketing.developer.dotdigital.com/reference/get-campaign-contact-clicks-and-link-groups.md) * [Get campaign page views for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-page-views-for-a-contact.md) * [Get campaign page views since date](https://marketing.developer.dotdigital.com/reference/get-campaign-page-views-since-date.md) * [Get campaign replies for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-replies-for-a-contact.md) * [Get campaign ROI activity for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-roi-activity-for-a-contact.md) * [Get campaign ROI activity since date](https://marketing.developer.dotdigital.com/reference/get-campaign-roi-activity-since-date.md) * [Get campaign social bookmark views](https://marketing.developer.dotdigital.com/reference/get-campaign-social-bookmark-views.md) * [Get campaign social bookmark views for a contact](https://marketing.developer.dotdigital.com/reference/get-campaign-social-bookmark-views-for-a-contact.md) * [Get campaign hard bouncers](https://marketing.developer.dotdigital.com/reference/get-campaign-hard-bouncers.md) * [Get campaign split test results](https://marketing.developer.dotdigital.com/reference/get-campaign-split-test-results.md) * [Get custom from addresses](https://marketing.developer.dotdigital.com/reference/get-custom-from-addresses.md) * [Get campaign revenue since date](https://marketing.developer.dotdigital.com/reference/get-campaign-revenue-since-date.md) * [Get campaign revenue for contact](https://marketing.developer.dotdigital.com/reference/get-campaign-revenue-for-contact.md)