> For the complete documentation index, see [llms.txt](https://developer.ballotpedia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ballotpedia.org/bulk-data/downloading-bulk-data-via-the-client-portal.md).

# Downloading bulk data via the client portal

Ballotpedia’s bulk data clients can access their data on-demand with our client portal at [https://clients.ballotpedia.org/](https://clients.ballotpedia.org/login). The data is refreshed every 24 hours. You may access your data through two methods, as described below:

1. Login with provided password and click to download latest file (detailed below)
2. Access latest data file via API (for technical users, see: [Downloading data via API](/bulk-data/downloading-bulk-data-via-api.md))

## Basic instructions

Login to the dashboard at <https://clients.ballotpedia.org> with the provided email and password.&#x20;

Upon logging in, you’ll see a list of your available queries with the title and description.

For each query, there are two available formats, JSON and CSV. Clicking on either of these buttons will begin the download process for the respective format.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdu3neeLl1XV4_E-ohgmO6xUmT_TnVs-MBc3SUrpajhE180Z8R0VRUfyRl2fSXI8QRn2AtRAdXjUKjKYu6mSZ4qVTwywfARCg5BvrWklalv67gVWTUnJC1D6uctJ357MLReQI5HDbpmnnRUB3CHTUPDIQg?key=WeVmNTzl4NMpWbwiYrf2-w" alt=""><figcaption><p>example of client portal</p></figcaption></figure>

Please contact Ballotpedia’s data sales team to request password changes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.ballotpedia.org/bulk-data/downloading-bulk-data-via-the-client-portal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.