API Reference for Marketo Engage

Describe Lead2

GET /rest/v1/leads/describe2.json

Returns list of searchable fields on lead objects in the target instance.

Operation ID
describeUsingGET_6
Permissions
Read-Only Lead, Read-Write Lead
Request format
application/json
Returns
ResponseOfLeadAttribute2

Responses

200 OK ResponseOfLeadAttribute2
errors array of Error required

Array of errors that occurred if the request was unsuccessful

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

moreResult boolean

Boolean indicating if there are more results in subsequent pages

nextPageToken string

Paging token given if the result set exceeded the allowed batch size

requestId string required

Id of the request made

result array of LeadAttribute2 required

Array of results for individual records in the operation, may be empty

Model LeadAttribute2

name string required

"API Lead"

searchableFields array of LeadAttribute2SearchableFields required

List of searchable fields

fields array of LeadAttribute2Fields required

Description of searchable fields

Model LeadAttribute2Fields

name string required

REST API name of field

displayName string required

Display name of field (friendly name)

dataType string required

Data type of field

length integer

Length of field

updateable boolean required

Is field updateable

crmManaged boolean required

Is field managed by CRM

success boolean required

Whether the request succeeded

warnings array of Warning required

Array of warnings given for the operation

Model Warning

code integer (int32) required

Integer code of the warning

message string required

Message describing the warning

Generated example
{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "moreResult": false,
  "nextPageToken": "example-token",
  "requestId": "123",
  "result": [
    {
      "name": "Example name",
      "searchableFields": [
        [
          "string"
        ]
      ],
      "fields": [
        {
          "name": "Example name",
          "displayName": "Example name",
          "dataType": "string",
          "length": 123,
          "updateable": true,
          "crmManaged": true
        }
      ]
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 123,
      "message": "string"
    }
  ]
}

Referenced models

Generated from swagger-mapi.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