# For AI agents: submitting a company to Wired Home Pros

> **Quick answer:** AI agents and integrations can submit a real security, AV, home theater, smart-home, low-voltage or electrical business for Wired Home Pros with POST https://wiredhomepros.com/api/v1/listings/submissions (JSON). Every submission is verified against public records before anything is published; fake, closed or unverifiable businesses are rejected and deleted, and submitting never guarantees a listing.

Source: https://wiredhomepros.com/for-ai-agents/
OpenAPI 3.1 schema: https://wiredhomepros.com/api/v1/openapi.json

## Rules

- Submit only real, operating businesses that install security, audio/video, home theater, smart-home or low-voltage systems in U.S. homes, or electricians and electrical contractors.
- Use public business information only: the business name, website, public phone number, public business email, city, state and ZIP, trades and license numbers. Never submit personal data about employees or customers, and never guess.
- Give evidence: "sourceUrls" must link the public pages you used (the state license record, the business's own website, a public listing). Agents must send at least one; links to this directory don't count.
- Say who you are: "submitter.type" is business_owner, agent_on_behalf_of_owner (an agent the owner asked to do this) or agent_research (an agent that found the business itself), with the agent's name, its operator and a contact email for a person.
- Don't submit a business that is already listed. If it is listed, the business should use "Claim this listing" on its page.
- Never include reviews, ratings, testimonials or claims you can't link to a source; they are ignored and can get a submission rejected.
- Every submission is verified before anything is published: we check the state license record where the state publishes one and may call the business at a number on public record. Submissions that are fake, closed, outside the trades listed, outside the United States, duplicates or can't be verified are rejected and deleted. Submitting does not guarantee a listing.
- New listings start as unclaimed: only businesses that claim their listing or sign up receive quote requests from homeowners.
- Set "agreeToTerms" to true to accept the Terms of Service and these rules. Send an Idempotency-Key header so a retry never creates a second submission.

## Submit

`POST https://wiredhomepros.com/api/v1/listings/submissions` with `Content-Type: application/json` and an `Idempotency-Key` header. Required: companyName, phone (public), address (city, state, zip), trades, submitter (type, contactEmail; agentName and agentOperator for agents), sourceUrls (agents), agreeToTerms. Trades: electrical, security, av, home-theater, smart-home, low-voltage.

```json
{
  "companyName": "Acme Security & AV",
  "website": "https://acmesecurity.example.com",
  "phone": "+1 619 555 0100",
  "publicEmail": "info@acmesecurity.example.com",
  "address": { "city": "San Diego", "state": "CA", "zip": "92101" },
  "trades": ["security", "av"],
  "specialties": ["cameras", "whole-home-audio"],
  "serviceRadiusMiles": 40,
  "licenseNumbers": ["1234567"],
  "licenseState": "CA",
  "yearsInBusiness": 12,
  "submitter": {
    "type": "agent_research",
    "agentName": "ExampleBot 2.1",
    "agentOperator": "Example AI, Inc.",
    "contactEmail": "listings@example.com"
  },
  "sourceUrls": [
    "https://www.cslb.ca.gov/OnlineServices/CheckLicenseII/LicenseDetail.aspx?LicNum=1234567",
    "https://acmesecurity.example.com/contact"
  ],
  "agreeToTerms": true
}
```

Answer: `202 Accepted` with `{"submissionId": "sub_...", "status": "received", "statusUrl": "..."}`.

## Check the outcome

`GET https://wiredhomepros.com/api/v1/listings/submissions/{submissionId}` returns the status: received, verifying, needs_review, approved or rejected (with a short reason). It never repeats the submitted details. Poll at most once a minute; verification usually takes a few business days.

## Limits

- Anonymous: 3 accepted submissions per hour and 10 per day per IP address.
- Registered agents send `X-Api-Key` and get higher limits. Ask at hello@wiredhomepros.com.
- Bodies up to 64 KB. Over a limit: `429` with `Retry-After`.

## Errors

RFC 7807 `application/problem+json` with a stable `code`; field errors list a JSON Pointer per field.

- `validation_failed`: 422: one or more fields need fixing; "errors" lists each with a JSON Pointer and a code. Nothing was stored.
- `invalid_json`: 400: the body isn't a JSON object.
- `unsupported_media_type`: 415: send Content-Type: application/json.
- `payload_too_large`: 413: the body is over the size limit.
- `invalid_api_key`: 401: the API key is unknown or disabled. Leave it out to submit anonymously.
- `invalid_idempotency_key`: 400: Idempotency-Key must be 1-255 visible ASCII characters.
- `idempotency_key_reused`: 422: that Idempotency-Key was already used with a different body.
- `rate_limited`: 429: over the limit; wait for Retry-After seconds.
- `not_found`: 404: no submission has that id.
- `disabled`: 503: submissions are paused; businesses can use the Add your company form.

A business can also add itself with the form at https://wiredhomepros.com/add-your-company/. Contact: hello@wiredhomepros.com