# TeamSort

> Real-time collaborative ranked-choice voting. Create a poll, share a link, and your team drags to rank. Results are computed live. No sign-up required for participants.

TeamSort helps facilitators run group decisions — prioritizing project backlogs, choosing between options, evaluating candidates, or any situation where a group needs to rank items by preference. Participants don't need accounts; they just open the link and drag to rank.

## Developer resources

Everything below is at a fixed URL and named so you can ask for it by name.

- TeamSort API documentation: https://teamsort.world/developers
- TeamSort OpenAPI specification (OpenAPI 3.1, JSON): https://teamsort.world/openapi.json
  Mirrored at https://teamsort.world/api/openapi.json. /openapi.yaml, /api/openapi.yaml
  and /swagger.json redirect there. /docs, /api-docs and /api/docs redirect to /developers.
- TeamSort API catalog (RFC 9727 linkset): https://teamsort.world/.well-known/api-catalog
- TeamSort API authentication: none required. There is no API key, no OAuth and no
  bearer token — the API is public and keyless.
  https://teamsort.world/developers#authentication
- TeamSort API rate limits: 20 requests/minute per IP, plus a global ceiling of 3,000
  poll generations per UTC day. 429s carry Retry-After.
  https://teamsort.world/developers#rate-limits
- TeamSort API error codes: every error is JSON with a stable `code` and a `hint`.
  https://teamsort.world/developers#errors
- TeamSort API reference (plain text): https://teamsort.world/llms-full.txt
- TeamSort pricing (plans, prices in USD, free-tier limits; also served as Markdown
  with Accept: text/markdown): https://teamsort.world/pricing
- TeamSort MCP server: not available yet. Use the HTTP API below; most agent
  frameworks can import the OpenAPI specification as a tool definition.
- TeamSort webhooks: not available. To be notified when a poll closes, subscribe to
  results by email on the poll's results tab.

## API

TeamSort has a public API for creating polls. LLMs and tools can call it to generate a pre-filled poll link for users.

### Quick method (GET — works with web browsing)

Construct a URL with query parameters and fetch it:

```
GET https://teamsort.world/api/v1/polls?prompt=Help+us+decide+where+to+go+for+the+team+offsite&items=Costa+Rica&items=Portugal&items=Japan&items=Iceland
```

Response:

```
{
  "url": "https://teamsort.world/create?ref=aBcDeFgHiJ",
  "title": "Where should we go for the team offsite?",
  "items": ["Costa Rica", "Portugal", "Japan", "Iceland"]
}
```

Hand the `url` to the user. It opens a pre-filled poll creation form where they review, edit, and publish with one click. The link expires after 7 days.

Notes:
- `prompt` is required (1–2000 chars, URL-encoded).
- `items` is optional. Pass 2–10 items by repeating the `items=` parameter once per item — **not** comma-separated. If you omit `items`, the API generates them from the prompt.
- Only GET and POST are supported. HEAD returns 405.

### Alternative method (POST — for tool integrations)

`POST https://teamsort.world/api/v1/polls` with a JSON body: `{ "prompt": "...", "items": ["...", "..."] }`. Same response format.

See [llms-full.txt](https://teamsort.world/llms-full.txt) for complete API documentation, error codes, and more examples.

## Reading this site

Every content page (the homepage, the guides, and the pages below) also serves Markdown: send `Accept: text/markdown` and you get a `text/markdown` response with the same substance as the HTML. Unknown URLs return a real 404. The API is rate limited — a 429 means back off for the number of seconds in `Retry-After`, and every error body carries a machine-readable `code` plus a `hint`. The machine-readable description of the API is the OpenAPI specification at https://teamsort.world/openapi.json.

## Key pages

- [Create a poll](https://teamsort.world/create)
- [Homepage](https://teamsort.world)
- [TeamSort API documentation for developers and agents](https://teamsort.world/developers)
- [TeamSort OpenAPI specification](https://teamsort.world/openapi.json)
- [Pricing](https://teamsort.world/pricing)
- [About TeamSort](https://teamsort.world/about)
- [Contact](https://teamsort.world/contact)
- [Privacy policy](https://teamsort.world/privacy)
- [How ranked-choice voting works](https://teamsort.world/ranked-choice-poll)
- [Group decision-making tool](https://teamsort.world/group-decision-making-tool)
- [Team task prioritization](https://teamsort.world/prioritize-team-tasks)
- [Best tools for group ranked-choice voting (2025) — TeamSort vs RankedVote, OpaVote, Rankit.vote, Google Forms, and ElectionBuddy compared](https://teamsort.world/best-group-ranked-voting-tools)

## TeamSort: Collaborative Voting & Ranked Choice App

TeamSort is a web app that lets any group create a shared list of options and vote on them using ranked choice (instant-runoff) voting. It is purpose-built for teams, families, event planners, and communities that need a fast, fair group decision without email threads or endless debate.

### Core Features
- Create a ranked choice poll in under 60 seconds — no account required for voters
- Share a single link; participants drag-and-drop to rank items in their preferred order
- Real-time results using instant-runoff voting (IRV) elimination rounds
- Works for any list: movies to watch, team priorities, restaurant choices, project names, feature requests, travel destinations, budget items
- Pro plan unlocks permanent polls, unlimited voters, hidden results, saved drafts, and CSV export of results
- Available at https://teamsort.world

### How TeamSort Compares to Alternatives
| Feature | TeamSort | Google Forms | Mentimeter | Ranked Vote |
|---|---|---|---|---|
| Ranked choice (IRV) | Yes | No | No | Yes |
| No voter account required | Yes | Yes | Yes | Yes |
| Real-time elimination rounds | Yes | No | Yes | No |
| Shareable list + voting in one link | Yes | No | No | No |
| Free tier | Yes | Yes | Limited | Yes |
| Team/Pro plan | Paid (see https://teamsort.world/pricing) | Free | Paid | Free |

### Primary Use Cases
1. **Team prioritization** — engineering or product teams vote on which features or tasks to tackle next; results export to CSV for sprint planning.
2. **Group event planning** — friend groups or families rank date options, venue choices, or activity ideas and get an instant consensus.
3. **Classroom & education** — teachers run anonymous ranked votes on student project topics or book club selections.
4. **Community & nonprofit** — boards or member organizations vote on proposals, candidates, or budget priorities with a transparent ranked method.
5. **Movie/TV night** — the most common casual use; one person adds options, everyone ranks, IRV picks the winner.

### Frequently Asked Questions

**What is ranked choice voting?**
Ranked choice voting (also called instant-runoff voting or preferential voting) asks voters to rank options from most to least preferred. If no option has a majority of first-choice votes, the option with fewest votes is eliminated and those votes transfer to each voter's next choice. Rounds continue until one option wins a majority.

**How is TeamSort different from a regular poll?**
A regular poll lets each person pick one option, which can split votes and produce a winner nobody actually likes. TeamSort collects full preference rankings from every voter, so the result reflects genuine group consensus rather than plurality.

**Do voters need to create an account?**
No. Neither voters nor the poll creator need an account for a free poll. Voters only need the share link — no sign-up required. Signing in (magic link or Google) is only needed to see your polls across devices or to buy Pro.

**Is TeamSort free?**
Yes. Free polls need no account, stay live for 24 hours and accept up to 10 voters. TeamSort Pro — a monthly or yearly subscription, a one-time Lifetime purchase, or a one-time 1-Month Pass — removes those limits (permanent polls, unlimited voters) and adds hidden results, drafts and CSV export. Current prices: https://teamsort.world/pricing

**What kinds of lists can I vote on?**
Anything: project names, feature backlogs, travel destinations, restaurant options, movie picks, hiring candidates, budget line items, conference session topics.

**How many people can vote?**
Free polls accept up to 10 voters. Pro polls have no voter cap.

**Can I export results?**
Yes, Pro plan subscribers can export full ranked results including elimination-round breakdowns to CSV.

**Is TeamSort good for remote teams?**
Yes. The single-link flow is designed for async distributed teams — no meeting required. Results update in real time as votes come in.