Marketo

Marketo Engage Lead Database API

The core Marketo Engage REST surface — person ("lead") records, activity and data-value-change feeds, companies, opportunities and opportunity roles, sales persons, named accounts and named account lists, custom objects and custom object types, custom activity types, static lists, smart campaigns, program members, API usage reporting, and the full bulk import/export job family. 147 operations under /rest/v1 and /bulk/v1, published by Adobe as Swagger 2.0. Field vocabularies are per-subscription and must be discovered at runtime through the describe operations.

GitHub OpenAPI

Documentation

📖
Documentation
https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api
📖
APIReference
https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/endpoint-reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/openapi/marketo-lead-database-openapi-original.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/overlays/marketo-lead-database-overlay.yaml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/data-model/marketo-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/errors/marketo-error-codes.yml

OpenAPI Specification

marketo-lead-database-openapi-original.json Raw ↑ 
{
  "swagger": "2.0",
  "info": {
    "description": "Marketo Engage Rest API",
    "version": "1.0",
    "title": "Marketo Engage Rest API",
    "termsOfService": "https://www.adobe.com/legal.html",
    "contact": {
      "name": "Adobe Developer Relations",
      "url": "https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home",
      "email": ""
    },
    "license": {
      "name": "API License Agreement",
      "url": "https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/api-license"
    }
  },
  "host": "localhost:8080",
  "basePath": "/",
  "schemes": ["https"],
  "tags": [
    {
      "name": "Activities",
      "description": "Activities Controller"
    },
    {
      "name": "Bulk Export Activities",
      "description": "Bulk Export Activities Controller"
    },
    {
      "name": "Bulk Export Custom Objects",
      "description": "Bulk Export Custom Objects Controller"
    },
    {
      "name": "Bulk Export Leads",
      "description": "Bulk Export Leads Controller"
    },
    {
      "name": "Bulk Export Program Members",
      "description": "Bulk Export Program Members Controller"
    },
    {
      "name": "Bulk Import Custom Objects",
      "description": "Bulk Import Custom Objects Controller"
    },
    {
      "name": "Bulk Import Leads",
      "description": "Bulk Import Leads Controller"
    },
    {
      "name": "Bulk Import Program Members",
      "description": "Bulk Import Program Members Controller"
    },
    {
      "name": "Campaigns",
      "description": "Campaigns Controller"
    },
    {
      "name": "Companies",
      "description": "Companies Controller"
    },
    {
      "name": "Custom Objects",
      "description": "Custom Objects Controller"
    },
    {
      "name": "Leads",
      "description": "Leads Controller"
    },
    {
      "name": "Named Account Lists",
      "description": "Named Account Lists Controller"
    },
    {
      "name": "Named Accounts",
      "description": "Named Accounts Controller"
    },
    {
      "name": "Opportunities",
      "description": "Opportunities Controller"
    },
    {
      "name": "Program Members",
      "description": "Program Members Controller"
    },
    {
      "name": "Sales Persons",
      "description": "Sales Persons Controller"
    },
    {
      "name": "Static Lists",
      "description": "Static Lists Controller"
    },
    {
      "name": "Usage",
      "description": "Stats Controller"
    }
  ],
  "paths": {
    "/bulk/v1/activities/export.json": {
      "get": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Get Export Activity Jobs",
        "description": "Returns a list of export jobs that were created in the past 7 days. Required Permissions: Read-Only Activity",
        "operationId": "getExportActivitiesUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "Comma separated list of statuses to filter on.",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "collectionFormat": "multi",
            "enum": [
              "created",
              "queued",
              "processing",
              "cancelled",
              "completed",
              "failed"
            ]
          },
          {
            "name": "batchSize",
            "in": "query",
            "description": "The batch size to return. The max and default value is 300.",
            "required": false,
            "type": "integer",
            "format": "int32"
          },
          {
            "name": "nextPageToken",
            "in": "query",
            "description": "A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter. See Paging Tokens for more info.",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponseWithToken"
            }
          }
        }
      }
    },
    "/bulk/v1/activities/export/create.json": {
      "post": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Create Export Activity Job",
        "description": "Create export job for search criteria defined via \"filter\" parameter. Request returns the \"exportId\" which is passed as a parameter in subsequent calls to Bulk Export Activities endpoints. Use Enqueue Export Activity Job endpoint to queue the export job for processing. Use Get Export Activity Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Activity",
        "operationId": "createExportActivitiesUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "exportActivityRequest",
            "description": "exportActivityRequest<br><br>ColumnHeaderNames: A JSON object containing key-value pairs of field and column header names.<br><br>Example:<br><code>\"columnHeaderNames\":{<br>  \"primaryAttributeValueId\":\"Attribute ID\",<br>  \"primaryAttributeValue\":\"Attribute Value\",<br>  \"attributes\":\"Secondary Attributes\"<br>}</code><br>",
            "required": false,
            "schema": {
              "$ref": "#/definitions/ExportActivityRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/activities/export/{exportId}/cancel.json": {
      "post": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Cancel Export Activity Job",
        "description": "Cancel export job. Required Permissions: Read-Only Activity",
        "operationId": "cancelExportActivitiesUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/activities/export/{exportId}/enqueue.json": {
      "post": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Enqueue Export Activity Job",
        "description": "Enqueue export job. This will place export job in queue, and will start the job when computing resources become available. The export job must be in \"Created\" state. Use Get Export Activity Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Activity",
        "operationId": "enqueueExportActivitiesUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/activities/export/{exportId}/file.json": {
      "get": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Get Export Activity File",
        "description": "Returns the file content of an export job. The export job must be in \"Completed\" state. Use Get Export Activity Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Activity<br><br>The file format is specified by calling the Create Export Activity Job endpoint. The following is an example of the default file format (\"CSV\"). Note that the \"attributes\" field is formatted as JSON.<br><br><code>marketoGUID,leadId,activityDate,activityTypeId,campaignId,primaryAttributeValueId,primaryAttributeValue, attributes</code><br><code>122323,6,2013-09-26T06:56:35+0000,12,11,6,Owyliphys Iledil,[{\"name\":\"Source Type\",\"value\":\"Web page visit\"}]</code>",
        "operationId": "getExportActivitiesFileUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "Range",
            "in": "header",
            "description": "To support partial retrieval of extracted data, the HTTP header \"Range\" of type \"bytes\" may be specified. See RFC 2616 \"Range Retrieval Requests\" for more information. If the header is not set, the entire contents will be returned.",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamRangeContent"
            }
          }
        }
      }
    },
    "/bulk/v1/activities/export/{exportId}/status.json": {
      "get": {
        "tags": [
          "Bulk Export Activities"
        ],
        "summary": "Get Export Activity Job Status",
        "description": "Returns status of an export job. Job status is available for 30 days after Completed or Failed status was reached. Required Permissions: Read-Only Activity",
        "operationId": "getExportActivitiesStatusUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/customobjects/{apiName}/import.json": {
      "post": {
        "tags": [
          "Bulk Import Custom Objects"
        ],
        "summary": "Import Custom Objects",
        "description": "Imports a file containing data records into the target instance. Required Permissions: Read-Write Custom Object",
        "operationId": "importCustomObjectUsingPOST",
        "consumes": [
          "multipart/form-data"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "apiName",
            "in": "path",
            "description": "API Name of the custom object for the import batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Import file format.",
            "required": true,
            "type": "string",
            "enum": [
              "csv",
              "tsv",
              "ssv"
            ]
          },
          {
            "name": "file",
            "in": "formData",
            "description": "File containing the data records to import.",
            "required": true,
            "type": "file"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportCustomObjectResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/customobjects/{apiName}/import/{batchId}/failures.json": {
      "get": {
        "tags": [
          "Bulk Import Custom Objects"
        ],
        "summary": "Get Import Custom Object Failures",
        "description": "Returns the list of failures for the import batch job. Required Permissions: Read-Write Custom Object",
        "operationId": "getImportCustomObjectFailuresUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "apiName",
            "in": "path",
            "description": "API Name of the custom object for the import batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/customobjects/{apiName}/import/{batchId}/status.json": {
      "get": {
        "tags": [
          "Bulk Import Custom Objects"
        ],
        "summary": "Get Import Custom Object Status",
        "description": "Returns the status of an import batch job. Required Permissions: Read-Write Custom Object",
        "operationId": "getImportCustomObjectStatusUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "apiName",
            "in": "path",
            "description": "API Name of the custom object for the import batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportCustomObjectResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/customobjects/{apiName}/import/{batchId}/warnings.json": {
      "get": {
        "tags": [
          "Bulk Import Custom Objects"
        ],
        "summary": "Get Import Custom Object Warnings",
        "description": "Returns the list of warnings for the import batch job. Required Permissions: Read-Write Custom Object",
        "operationId": "getImportCustomObjectWarningsUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "apiName",
            "in": "path",
            "description": "API Name of the custom object for the import batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/program/{programId}/members/import.json": {
      "post": {
        "tags": [
          "Bulk Import Program Members"
        ],
        "summary": "Import Program Members",
        "description": "Imports a file containing data records into the target instance. Required Permissions: Read-Write Lead",
        "operationId": "importProgramMemberUsingPOST",
        "consumes": [
          "multipart/form-data"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "programId",
            "in": "path",
            "description": "Id of the program to add members to.",
            "required": true,
            "type": "string"
          },
          {
            "name": "programMemberStatus",
            "in": "query",
            "description": "Program member status for members being added.",
            "required": true,
            "type": "string"
          },		  
          {
            "name": "format",
            "in": "query",
            "description": "Import file format.",
            "required": true,
            "type": "string",
            "enum": [
              "CSV",
              "TSV",
              "SSV"
            ]
          },
          {
            "name": "file",
            "in": "formData",
            "description": "File containing the data records to import.",
            "required": true,
            "type": "file"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportProgramMemberResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/program/members/import/{batchId}/failures.json": {
      "get": {
        "tags": [
          "Bulk Import Program Members"
        ],
        "summary": "Get Import Program Member Failures",
        "description": "Returns the list of failures for the import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportProgramMemberFailuresUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/program/members/import/{batchId}/status.json": {
      "get": {
        "tags": [
          "Bulk Import Program Members"
        ],
        "summary": "Get Import Program Member Status",
        "description": "Returns the status of an import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportProgramMemberStatusUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportProgramMemberResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/program/members/import/{batchId}/warnings.json": {
      "get": {
        "tags": [
          "Bulk Import Program Members"
        ],
        "summary": "Get Import Program Member Warnings",
        "description": "Returns the list of warnings for the import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportProgramMemberWarningsUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/leads.json": {
      "post": {
        "tags": [
          "Bulk Import Leads"
        ],
        "summary": "Import Leads",
        "description": "Imports a file containing data records into the target instance. Required Permissions: Read-Write Lead",
        "operationId": "importLeadUsingPOST",
        "consumes": [
          "multipart/form-data"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Import file format.",
            "required": true,
            "type": "string",
            "enum": [
              "csv",
              "tsv",
              "ssv"
            ]
          },
          {
            "name": "lookupField",
            "in": "query",
            "description": "Field to use for deduplication. Custom fields (string, email, integer), and the following field types are supported: id, cookies, email, twitterId, facebookId, linkedInId, sfdcAccountId, sfdcContactId, sfdcLeadId, sfdcLeadOwnerId, sfdcOpptyId. Default is email.<br>Note: You can use id for update only operations. ",
            "required": false,
            "type": "string"
          },
          {
            "name": "partitionName",
            "in": "query",
            "description": "Name of the lead partition to import to.",
            "required": false,
            "type": "string"
          },
          {
            "name": "listId",
            "in": "query",
            "description": "Id of the static list to import into.",
            "required": false,
            "type": "integer",
            "format": "int32"
          },
          {
            "name": "file",
            "in": "formData",
            "description": "File containing the data records to import.",
            "required": true,
            "type": "file"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportLeadResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/batch/{batchId}.json": {
      "get": {
        "tags": [
          "Bulk Import Leads"
        ],
        "summary": "Get Import Lead Status",
        "description": "Returns the status of an import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportLeadStatusUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfImportLeadResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/batch/{batchId}/failures.json": {
      "get": {
        "tags": [
          "Bulk Import Leads"
        ],
        "summary": "Get Import Lead Failures",
        "description": "Returns the list of failures for the import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportLeadFailuresUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/batch/{batchId}/warnings.json": {
      "get": {
        "tags": [
          "Bulk Import Leads"
        ],
        "summary": "Get Import Lead Warnings",
        "description": "Returns the list of warnings for the import batch job. Required Permissions: Read-Write Lead",
        "operationId": "getImportLeadWarningsUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "batchId",
            "in": "path",
            "description": "Id of the import batch job.",
            "required": true,
            "type": "integer",
            "format": "int32"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ObservableOfInputStreamContent"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/export.json": {
      "get": {
        "tags": [
          "Bulk Export Leads"
        ],
        "summary": "Get Export Lead Jobs",
        "description": "Returns a list of export jobs that were created in the past 7 days. Required Permissions: Read-Only Lead",
        "operationId": "getExportLeadsUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "Comma separated list of statuses to filter on.",
            "required": false,
            "type": "array",
            "items": {
              "type": "string"
            },
            "collectionFormat": "multi",
            "enum": [
              "created",
              "queued",
              "processing",
              "cancelled",
              "completed",
              "failed"
            ]
          },
          {
            "name": "batchSize",
            "in": "query",
            "description": "The batch size to return. The max and default value is 300.",
            "required": false,
            "type": "integer",
            "format": "int32"
          },
          {
            "name": "nextPageToken",
            "in": "query",
            "description": "A token will be returned by this endpoint if the result set is greater than the batch size and can be passed in a subsequent call through this parameter. See Paging Tokens for more info.",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponseWithToken"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/export/create.json": {
      "post": {
        "tags": [
          "Bulk Export Leads"
        ],
        "summary": "Create Export Lead Job",
        "description": "Create export job for search criteria defined via \"filter\" parameter. Request returns the \"exportId\" which is passed as a parameter in subsequent calls to Bulk Export Leads endpoints. Use Enqueue Export Lead Job endpoint to queue the export job for processing. Use Get Export Lead Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Lead",
        "operationId": "createExportLeadsUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "exportLeadRequest",
            "description": "exportLeadRequest<br><br>ColumnHeaderNames: A JSON object containing key-value pairs of field and column header names.<br><br>Example:<br><code>\"columnHeaderNames\":{<br>  \"firstName\":\"First Name\",<br>  \"lastName\":\"Last Name\",<br>  \"email\":\"Email Address\"<br>}</code><br>",
            "required": false,
            "schema": {
              "$ref": "#/definitions/ExportLeadRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/export/{exportId}/cancel.json": {
      "post": {
        "tags": [
          "Bulk Export Leads"
        ],
        "summary": "Cancel Export Lead Job",
        "description": "Cancel export job. Required Permissions: Read-Only Lead",
        "operationId": "cancelExportLeadsUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/export/{exportId}/enqueue.json": {
      "post": {
        "tags": [
          "Bulk Export Leads"
        ],
        "summary": "Enqueue Export Lead Job",
        "description": "Enqueue export job. This will place export job in queue, and will start the job when computing resources become available. The export job must be in \"Created\" state. Use Get Export Lead Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Lead",
        "operationId": "enqueueExportLeadsUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/ResponseOfExportResponse"
            }
          }
        }
      }
    },
    "/bulk/v1/leads/export/{exportId}/file.json": {
      "get": {
        "tags": [
          "Bulk Export Leads"
        ],
        "summary": "Get Export Lead File",
        "description": "Returns the file content of an export job. The export job must be in \"Completed\" state. Use Get Export Lead Job Status endpoint to retrieve status of export job. Required Permissions: Read-Only Lead<br><br>The file format is specified by calling the Create Export Lead Job endpoint. The following is an example of the default file format (\"CSV\").<br><br><code>firstName,lastName,email</code><br><code>Marvin,Gaye,marvin.gaye@motown.com</code>",
        "operationId": "getExportLeadsFileUsingGET",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "name": "exportId",
            "in": "path",
            "description": "Id of export batch job.",
            "required": true,
            "type": "string"
          },
          {
            "name": "Range",
            "in": "header",
            "description": "To support partial retrieval of extracted data, the HTTP header \"Range\" of type \"bytes\" may be specified. See RFC 2616 \"Range Retrieval Requests\" for more information. If the header is not set, the entire contents will be returned.",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schem

# --- truncated at 32 KB (357 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/marketo/refs/heads/main/openapi/marketo-lead-database-openapi-original.json