> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tally

> Read Tally forms, form submissions, and workspaces to analyze responses collected with the form builder

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `TALLY_API_KEY` is sent as the `Bearer` prefixed `Authorization` header.
* **Docs**: [https://developers.tally.so/api-reference/api-keys](https://developers.tally.so/api-reference/api-keys)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable        | Required | Description                                                                                                                             |
| --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `TALLY_API_KEY` | Yes      | Tally API key (created in Tally under Settings > API keys; shown only once) [Docs](https://developers.tally.so/api-reference/api-keys). |

## Setup

1. **Create an API key**: Sign in to Tally (free accounts work - the API is available to all users), go to Settings > API keys, and click 'Create API key'. Copy the key immediately; it is shown only once.
2. **Set the environment variable**: Add TALLY\_API\_KEY to your .env.
3. **Verify access**: Run List Forms. The key is sent as Authorization: Bearer \<key> against [https://api.tally.so](https://api.tally.so).

* For real-time submission data, Tally recommends webhooks over polling the submissions endpoint.
* List endpoints are paginated with page/limit and return hasMore plus total counts.

Provider API reference: [https://developers.tally.so/api-reference/introduction](https://developers.tally.so/api-reference/introduction)

## Tools

| Tool                | Access | Description                                                                                                                        |
| ------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| List Forms          | Read   | List forms in the Tally account, optionally filtered by workspace                                                                  |
| Get Form            | Read   | Retrieve a single form by ID with all its blocks and settings                                                                      |
| List Submissions    | Read   | List submissions of a form with their responses, filterable by status and date range                                               |
| Get Submission      | Read   | Retrieve a specific form submission with all its responses and the form questions                                                  |
| List Form Questions | Read   | List a form's questions with their IDs, types, and response counts - lighter than parsing the full form blocks for mapping answers |
| List Workspaces     | Read   | List workspaces with their members and pending invites                                                                             |

## Example prompts

* List my Tally forms, pick the most recently updated one, and summarize its latest submissions.
* Give me an overview of my Tally forms with their status and number of submissions.
* For a given Tally form, compare completed vs partial submissions and report the completion rate.