Create Bulk Export

Use this API to create a bulk export based on the specified criteria.

🗒

Things to Know

• For COOKIE_RECEIPTS exports, please reach out to your OneTrust representative or production support before running.
• Each account is limited to 20 bulk exports per month. If you cancel a bulk export before it completes, it will not be counted towards this limit. Please contact OneTrust Support or your Customer Success Manager (CSM) to increase your export limit.
• The timespan for endDate-startDate is limited to 6 months.
• endDate can be as recent as yesterday, but cannot be the current day.
• CONSENT_RECEIPTS and COOKIE_RECEIPTS only support filtering based oncollectionPointGuid or purposeGuid. Both cannot be used at the same time.
• CONSENT_RECEIPTS and COOKIE_RECEIPTS exports will become available once the feature is enabled.
• For DATA_SUBJECTS exports, only data subjects with a recorded consent transaction will be included.
• If a value is not provided for the dateType parameter in DATA_SUBJECTS exports, this will be set to CREATED_DATE by default.
• The status of a bulk export will automatically change to Expired 10 days after its creation.
• For bulk exports less than 1 million records, we recommend using a report to pull the list. As it cannot be guaranteed that the bulk export reaches this maximum, the results will be split across multiple files up to 1 million records.
• The maximum limit allowed is 1 million records, which is equivalent to approximately 8MB for COOKIE_RECEIPTS and CONSENT_RECEIPTS exports.

{
  "exportType": "CONSENT_RECEIPTS",
  "startDate": "2023-07-01",
  "endDate": "2023-12-01",
  "params": [
    {
      "name": "collectionPointGuid",
      "values": [
        "af01cad5-a39d-4585-9ee1-2062b1426bdd"
      ]
    }
  ]
}

{
  "exportType": "COOKIE_RECEIPTS",
  "startDate": "2023-11-01",
  "endDate": "2023-12-01",
  "params": [
    {
      "name": "purposeGuid",
      "values": [
        "af01cad5-a39d-4585-9ee1-2062b1426bdd"
      ]
    }
  ]
}

{
    "exportType": "DATA_SUBJECTS",
    "startDate": "2024-01-01",
    "endDate": "2024-06-01",
    "params": [
        {
            "name": "lastTransactionCollectionPointId",
            "values": [
                "c0431f94-664b-431e-bff3-3b341571c2af"
            ]
        },
        {
            "name": "purposeId",
            "values": [
                "514780d1-7797-4952-84e7-d6c70b018fed",
                "fb1ec920-68cd-4c9a-99da-77b21bd5b9d5",
                "55ede8d8-0aab-40b8-a6b7-6c5221b62aa7"
            ]
        },
        {
            "name": "status",
            "values": [
                "ACTIVE"
            ]
        },
        {
            "name": "dataElementName",
            "values":[
                "FirstName"
            ]
        },
                {
            "name": "dataElementValue",
            "values":[
                "George"
            ]
        }
    ]
}