API Reference for Marketo Engage

Get Programs

GET /rest/asset/v1/programs.json

Retrieves the list of accessible programs from the target instance.

Operation ID
browseProgramsUsingGET
Permissions
Read-Only Assets, Read-Write Assets
Request format
application/x-www-form-urlencoded
Returns
ResponseOfBrowseAllPrograms

Parameters

Query 5

maxReturn integer (int32)

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

offset integer (int32)

Integer offset for paging

filterType string

Optional filter. Requires filterValues

Values id programId folderId workspace

earliestUpdatedAt string

Exclude programs prior to this date. Must be valid ISO-8601 string. See Datetime field type description.

latestUpdatedAt string

Exclude programs after this date. Must be valid ISO-8601 string. See Datetime field type description.

Responses

200 OK ResponseOfBrowseAllPrograms
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 BrowseAllPrograms

Model BrowseAllPrograms

channel string required

Channel of the program

createdAt string (date-time)

Datetime the asset was created

description string

Description of the asset

folder Folder required

JSON representation of parent folder, with members 'id', and 'type' which may be 'Folder' or 'Program'

Model Folder

id integer (int32) required

Id of the folder

type string required

Type of folder

Values Folder Program

id integer (int64)

Id of the asset

name string

Name of the asset

sfdcId string

SFDC id of the program if linked to an SFDC campaign

sfdcName string

Name of the linked SFDC campaign if applicable

status string required

Status of the program. Only valid for Email and engagement program types.

Values locked unlocked on off

type string required

Type of the program

Values program event webinar nurture

updatedAt string (date-time)

Datetime the asset was most recently updated

url string

Url of the asset in the Marketo UI

workspace string

Name of the workspace

success boolean
warnings array of string
Generated example
{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "channel": "string",
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "string",
      "folder": {
        "id": 123,
        "type": "Folder"
      },
      "id": 123,
      "name": "Example name",
      "sfdcId": "123",
      "sfdcName": "Example name",
      "status": "locked",
      "type": "program",
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com",
      "workspace": "string"
    }
  ],
  "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.

↑ ↓ to move, ↵ to open, esc to closeSee all results