Segments

GET a Segment's Details

Changed on

Use this method to get details about a segment, including the segment criteria. If you know the segment_id You can also use this method to get details about a deleted segment. For more use case information, see Get a Segment's Details in the API guide.

get/segments/{segment_id}

Request

  • Base URL
    https://api.cc.email/v3
  • URL
    https://api.cc.email/v3/segments/{segment_id}
  • Auth
    • OAuth 2
      Implicit: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Scopes: contact_data
    • or OAuth 2
      Authorization code: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Token URL: https://authz.constantcontact.com/oauth2/default/v1/token scopes: contact_data

Path parameters

segment_idinteger required

The system-generated unique ID that identifies a segment.

Response

The segment was successfully returned.

namestring

The segment's unique descriptive name.

segment_criteriastring

The segment's contact selection criteria formatted as single-string escaped JSON.

segment_idinteger

The system generated number that uniquely identifies the segment.

created_atstring date-time

The system generated date and time (ISO-8601) that the segment was created.

edited_atstring date-time

The system generated date and time (ISO-8601) that the segment's <code>name</code> or <code> segment_criteria</code> was last updated.

Example response

{
  "name": "Re-engage contacts who did not open the last 5 email campaign activities.",
  "segment_criteria": "{\"version\":\"1.0.0\",\"criteria\":{\"type\":\"and\",\"group\":[{\"source\":\"tracking\",\"field\":\"not_opened\",\"op\":\"contains-any\",\"const_value\":\"last-n-campaigns\",\"param\":\"5\"}]}}",
  "segment_id": 14,
  "created_at": "2019-04-25T11:08:00.000Z",
  "edited_at": "2019-04-25T11:08:00.000Z"
}

Changes