---
updatedAt: 2025-06-12T20:24:48.000Z
agentTools:
  projectIndex: https://developer.accelevents.com/llms.txt
---

# Download Ticket Holder Data in CSV Format

This API used to download the ticket holder data in CSV format for a specified event.

This API can be accessed by Event Admins, Organizer Admins, and Enterprise Admins.

Description of response attributes. Attributes are returned as JSON.\
If the response returns successfully you will receive a `Success` response.

| Attribute   | Description                                                    |
| :---------- | :------------------------------------------------------------- |
| **type**    | Type of API response. i.e Success or Fail.                     |
| **message** | The body of the API response containing date for the end user. |

To call this API, you may pass in the startTime and endTime for the date range of orders you would like to access.

The response will include a CSV with all properties associated with `Ticket Holders` for a given event. Please note, if you are only capturing information for `Ticket Buyers` or if you are capturing other properties for `Ticket Buyers` you will want to use the `Ticket Buyer` endpoint.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "accelevents",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.accelevents.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/rest/host/event/{eventUrl}/performance/ticketing/holder/CSV": {
      "get": {
        "summary": "Download Ticket Holder Data in CSV Format",
        "description": "This API used to download the ticket holder data in CSV format for a specified event.",
        "operationId": "download-ticket-holder-data-in-csv-format",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "API Authentication Token",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "recurringEventId",
            "in": "query",
            "description": "For recurring events, enter the recurring Event ID.",
            "schema": {
              "type": "integer",
              "format": "int64",
              "default": 0
            }
          },
          {
            "name": "dataType",
            "in": "query",
            "description": "Pass Ticket Holder data type. E.g. `TICKET` or `ADDON`.",
            "schema": {
              "type": "string",
              "enum": [
                "TICKET",
                "ADDON"
              ]
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "description": "Add the Start Time for the order date that you want returned in the CSV. e.g. 2023/02/27 13:57:21",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "description": "Add the End Time for the order date that you want returned in the CSV. e.g. 2023/02/27 13:57:21",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "eventUrl",
            "in": "path",
            "description": "Event url is unique identifier for your event. E.g https://www.accelevents.com/e/demo. Here \"demo\" is the event URL..",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"string\",\n  \"type\": \"string\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "string"
                    },
                    "type": {
                      "type": "string",
                      "example": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"The request could not be understood by the server due to malformed syntax.\",\n  \"type\": \"string\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "The request could not be understood by the server due to malformed syntax."
                    },
                    "type": {
                      "type": "string",
                      "example": "string"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "You are not authorized to view the resource."
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "Accessing the resource you were trying to reach is forbidden."
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "The resource you were trying to reach was not found."
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "4XX",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "You do not have the required Event Admin permissions."
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```