[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Colorado DORA contractor search](https://spiral.ai/integrations/codex/colorado-dora-contractor-search)

# How to Use Colorado DORA contractor search in Codex

Returns matching Colorado DORA licenses with status, dates, and published disciplinary information, ordered newest first. Use it to find business credentials for a contractor shortlist or research newly issued trade licenses.

|  |  |
| --- | --- |
| Model | Colorado DORA contractor search |
| Available through | Alexandria |
| Category | Listings |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Colorado DORA contractor search in Codex

- Use Colorado DORA contractor search to retrieve active electrical contractor business licenses in Denver and populate the project's vendor review table with license numbers, statuses, and expiration dates.
- Use Colorado DORA contractor search to fetch Denver plumbing contractor licenses issued since October 1, 2026, and create a dated research report in the project.
- Use Colorado DORA contractor search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Colorado DORA contractor search and tell me what changed since last week.
- Check Colorado DORA contractor search and summarize what you find in three bullet points.

## How to set up Colorado DORA contractor search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Colorado DORA contractor search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "data-colorado-gov/licenses/search_contractors",
    "input": {
      "zip": "<zip>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Colorado DORA contractor search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Colorado DORA contractor search tools and prices

- [Colorado DORA professional and trade licences · Search contractors](https://spiral.ai/tools/alexandria/data-colorado-gov/licenses/search_contractors) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| zip |  | — | Five-digit mailing ZIP code. Pattern: ^[0-9]{5}$. |
| city |  | — | Mailing city, case-insensitive exact match (Denver). |
| name |  | — | Case-insensitive name words: each must appear in the business name or in the licensee's first or last name (eagle electric, john smith). |
| limit | 1 to 100 | 25 | Most licences per page. |
| cursor |  | — | next_cursor of the previous page, with the same filters. Pattern: ^[0-9]{1,9}\.[0-9a-f]{8}$. |
| status | active, inactive, all | active | active: statuses beginning Active (including With Conditions and Restricted); inactive: every other status; all. Defaults to active, or all when license_number is given. |

## What can you do with Colorado DORA contractor search in Codex?

Build a Colorado electrical or plumbing license review table in your project. Have the agent turn returned DORA records into readable credential information for vendor reviewers.

### Prepare an electrical bid review

Identify the DORA credential categories relevant to an electrical bid, find the bidding businesses' licenses, and assemble their recorded statuses, expiration dates, and published actions for review.

### Review plumbing vendor renewals

Match plumbing vendors to their DORA license types and records. Put the type's renewal cycle beside each business license's expiration date to plan follow-up reviews.

### Read published electrical contractor discipline

Find an electrical contractor's license and summarize the disciplinary actions DORA publishes with the record. Include the reported license status and dates so reviewers can read the actions in context.

### Standardize vendor credential labels

Replace inconsistent electrical and plumbing credential labels in a vendor register with DORA's category, type, and prefix. Compare each business's recorded credential with the reference before assigning the label.

### Build a trade-license research directory

Create a directory of electrical or plumbing business licenses for a Colorado city. Use DORA's type names to organize entries and display each license's recorded status and expiration date with Colorado's required notices.

### Research newly licensed trade businesses

Find newly issued electrical or plumbing contractor licenses in Denver, then examine the business records. Produce a research brief showing issue dates, reported statuses, and published disciplinary information.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Colorado DORA contractor search in other agents

- [Amp](https://spiral.ai/integrations/amp/colorado-dora-contractor-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/colorado-dora-contractor-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/colorado-dora-contractor-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/colorado-dora-contractor-search)
- [Cline](https://spiral.ai/integrations/cline/colorado-dora-contractor-search)
- [Cursor](https://spiral.ai/integrations/cursor/colorado-dora-contractor-search)
- [Devin](https://spiral.ai/integrations/devin/colorado-dora-contractor-search)
- [dots](https://spiral.ai/integrations/dots/colorado-dora-contractor-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/colorado-dora-contractor-search)
- [Gemini](https://spiral.ai/integrations/gemini/colorado-dora-contractor-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/colorado-dora-contractor-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/colorado-dora-contractor-search)
- [goose](https://spiral.ai/integrations/goose/colorado-dora-contractor-search)
- [Grok](https://spiral.ai/integrations/grok/colorado-dora-contractor-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/colorado-dora-contractor-search)
- [Hermes](https://spiral.ai/integrations/hermes/colorado-dora-contractor-search)
- [Instinct](https://spiral.ai/integrations/instinct/colorado-dora-contractor-search)
- [Manus](https://spiral.ai/integrations/manus/colorado-dora-contractor-search)
- [Muse](https://spiral.ai/integrations/muse/colorado-dora-contractor-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/colorado-dora-contractor-search)
- [n8n](https://spiral.ai/integrations/n8n/colorado-dora-contractor-search)
- [Notion](https://spiral.ai/integrations/notion/colorado-dora-contractor-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/colorado-dora-contractor-search)
- [opencode](https://spiral.ai/integrations/opencode/colorado-dora-contractor-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/colorado-dora-contractor-search)
- [Raycast](https://spiral.ai/integrations/raycast/colorado-dora-contractor-search)
- [VS Code](https://spiral.ai/integrations/vscode/colorado-dora-contractor-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/colorado-dora-contractor-search)
- [Zapier](https://spiral.ai/integrations/zapier/colorado-dora-contractor-search)

## More Codex guides

- [Cincinnati permit details](https://spiral.ai/integrations/codex/cincinnati-permit-details)
- [Colorado DORA license details](https://spiral.ai/integrations/codex/colorado-dora-license-details)
- [Cincinnati contractor activity](https://spiral.ai/integrations/codex/cincinnati-contractor-activity)
- [Colorado DORA license types](https://spiral.ai/integrations/codex/colorado-dora-license-types)
- [Cincinnati code enforcement cases](https://spiral.ai/integrations/codex/cincinnati-code-enforcement-cases)
- [Columbus building permit details](https://spiral.ai/integrations/codex/columbus-building-permit-details)

## Questions about Colorado DORA contractor search in Codex

**Can Codex use Colorado DORA contractor search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Colorado DORA contractor search like any built-in tool.

**How much does Colorado DORA contractor search cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Colorado DORA contractor search in Codex?**

No. Spiral runs Colorado DORA contractor search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Colorado DORA contractor search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Colorado DORA contractor search runs?**

Colorado DORA contractor search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does this cover Colorado general contractors?**

Colorado general contractors are licensed by cities and counties, so they are outside this DORA lookup's coverage. A missing general contractor record here does not establish whether the business holds a local license.

**How often does the DORA data update?**

The portal describes license records as nightly research extracts. The separate license-type reference lists an annual manual update schedule, so its classifications and renewal information follow a different cadence.

**Is the extract the final authority on current license status?**

The portal identifies DORA's real-time licensing lookup as the primary source for consumer protection checks. Colorado also disclaims warranties about the portal data's accuracy, completeness, and timeliness.

**Why can a license say Active after its expiration date?**

The provider documents that Colorado's extract can still report Active after the recorded expiration date. Keep both values in the review and check DORA's primary verification record to resolve the discrepancy.

**Does DORA distinguish company licenses from individual credentials?**

Yes. DORA's license-type reference identifies whether a type belongs to a business or an individual, alongside its category, prefix, and renewal cycle.

