Get Segments For Segmentation

GET /rest/asset/v1/segmentation/{id}/segments.json

Retrieves a list of segments inside the target segmentation.

Operation ID: getSegmentsForSegmentationUsingGET
Permissions: Read-Only Assets, Read-Write Assets
Request format: application/json
Returns: ResponseOfSegmentsResponse

Parameters

Path 1

id integer (int32) required

Query 3

status string

Status filter for draft or approved versions

Values approved draft

offset integer (int32)

Integer offset for paging

maxReturn integer (int32)

Maximum number of records to return. Max 200, default 20

Responses

200 OK ResponseOfSegmentsResponse

errors array of Error

Model Error

code string required

Error code of the error. See full list of error codes here

message string required

Message describing the cause of the error

requestId string

result array of SegmentsResponse

Model SegmentsResponse

createdAt string (date-time)

Datetime the asset was created

description string

Description of the asset

id integer (int64)

Id of the asset

name string

Name of the asset

segmentationId integer (int32) required

Id of the Segmentation

updatedAt string (date-time)

Datetime the asset was most recently updated

url string

Url of the asset in the Marketo UI

success boolean

warnings array of string

Generated example

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "string",
      "id": 123,
      "name": "Example name",
      "segmentationId": 123,
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com"
    }
  ],
  "success": true,
  "warnings": [
    "string"
  ]
}

Referenced models

Generated from swagger-asset.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.