Available for Slack Only

Your Recognition Data, Ready for Your Own Tools

The HeyTaco API lets you pull live leaderboard data straight out of Slack — who's giving, who's receiving, and how it's trending — so you can build it into the dashboards, bots, and reports your team already uses.

Get Started View API Docs

Recognition data shouldn't be stuck in a Slack channel

Your team's tacos already tell a story — who's collaborating, which teams are thriving, where momentum is building. The HeyTaco API lets developers pull that story out of Slack and put it to work anywhere you need it.

Get Started

Example response for GET /leaderboard?type=received&timeframe=month

Rank	Person	Total Tacos
1	Tilly	75
2	Fitz	65
3	Koko	49
4	Angus	35

What You Can Build With the API

Simple, token-authenticated access to your team's recognition activity.

Custom dashboards

Pipe leaderboard data into the internal tools your team already checks, instead of sending people to another app.

Slack-native automations

Build your own bots and workflows on top of taco data, tailored to exactly how your team operates.

Sync with your stack

Feed recognition activity into your BI tool or data warehouse, right alongside the metrics you already track.

For developers, secured by design

Personal, scoped API tokens generated right from your HeyTaco profile — no shared secrets to pass around.
Filter leaderboard data by tacos given, received, or combined, across any timeframe from today to all-time.
Built-in rate limiting and caching keep every request fast and reliable.
Actively evolving — follow the changelog for new capabilities as they ship.

Frequently Asked Questions

Common questions about the HeyTaco API.

What is the HeyTaco API?

The HeyTaco API lets developers pull recognition data — like who's giving and receiving tacos — out of Slack and into their own tools, dashboards, or internal workflows, using a simple token-authenticated REST endpoint.

Which platforms does the HeyTaco API support?

The API is available for Slack teams only today. Support for additional platforms may come as the API expands — check the changelog for updates.

What data can I access with the API?

The API currently exposes team leaderboard data, filterable by tacos given, received, or combined, across timeframes from today to all-time, or a custom date range.

How do I authenticate with the HeyTaco API?

Generate a personal API token from your HeyTaco profile, scope it to what you need, and pass it as a bearer token on your requests.

Is the HeyTaco API rate limited?

Yes. Requests are rate-limited and responses are cached to keep the API fast and reliable for every team using it.

Where can I find the full API documentation?

Full documentation, including endpoint references, scopes, and a changelog of new capabilities, lives at api.heytaco.com/docs.