# Teamcolorcodes — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get official color codes for sports teams across NFL, NBA, MLB, NHL, NCAA, and international soccer leagues, then search and browse teams to find their exact hex and RGB colors. Perfect for designing fan apps, merchandise, or any project that needs authentic team branding information.

**Category:** Sports | **Website:** [teamcolorcodes.com/](https://teamcolorcodes.com/) | **Docs:** [parse.bot/marketplace/327a3b12-fdcd-4cc0-8a1f-074565ff4c3c/teamcolorcodes-com-api](https://parse.bot/marketplace/327a3b12-fdcd-4cc0-8a1f-074565ff4c3c/teamcolorcodes-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/teamcolorcodes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get team colors

Get detailed color codes for a specific team. Returns color sections parsed from the team page, each containing individual color entries with available format values (Hex, RGB, CMYK, Pantone, Color Name). Different sections may contain subsets of formats (e.g. a Pantone-only section, an RGB-only section). The first section typically has all formats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_url` | string | Yes | Full URL of the team color codes page (e.g. https://teamcolorcodes.com/dallas-cowboys-color-codes/). Obtain from list_teams or search_teams results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/teamcolorcodes/get-team-colors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"team_url":"<string>"}'
```

### List leagues

List all supported sports leagues and their relative paths. Returns a static list of 12 leagues spanning NFL, NBA, MLB, NHL, MLS, EPL, NCAA, WNBA, La Liga, Serie A, Bundesliga, and Ligue 1. Each league entry provides the path needed to query its teams via list_teams.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/teamcolorcodes/list-leagues \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List teams

List all teams in a specific league. Fetches the league page and extracts team links with their full URLs. The returned URLs are suitable for passing directly to get_team_colors. Results may include promoted/related teams from the page sidebar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_path` | string | Yes | Relative path of the league (e.g. /nfl-team-color-codes/, /nba-team-color-codes/). Obtain from list_leagues endpoint. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/teamcolorcodes/list-teams \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"league_path":"<string>"}'
```

### Search teams

Search for teams by name across leagues. Performs case-insensitive partial matching on team names. Searches up to 6 leagues (all by default, or a single league if league_path is specified). Returns matching teams with their URLs and league paths. Stops after 50 matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_path` | string | No | Optional league path to restrict search to a single league (e.g. /nba-team-color-codes/). Omitting searches across all leagues. |
| `query` | string | Yes | Team name or keyword to search for (case-insensitive partial match). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/teamcolorcodes/search-teams \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"league_path":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.