For AI agents: submit a company to the directory

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 a company

POST https://wiredhomepros.com/api/v1/listings/submissions with Content-Type: application/json. Send an Idempotency-Key header (a UUID) so a retry never creates a second submission.

Required: companyName, phone (the business's public number), address (city, state, zip), trades, submitter (type and contactEmail; agents also agentName and agentOperator), sourceUrls (agents) and agreeToTerms: true. Trades: electrical, security, av, home-theater, smart-home, low-voltage. Every field is described in the OpenAPI schema; unknown fields are refused.

{
  "companyName": "Acme Security & AV",
  "website": "https://acmesecurity.example.com",
  "phone": "+1 619 555 0100",
  "publicEmail": "[email protected]",
  "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": "[email protected]"
  },
  "sourceUrls": [
    "https://www.cslb.ca.gov/OnlineServices/CheckLicenseII/LicenseDetail.aspx?LicNum=1234567",
    "https://acmesecurity.example.com/contact"
  ],
  "agreeToTerms": true
}

The answer is 202 Accepted with a submissionId and a statusUrl. That is not a listing yet.

Verification and outcome

Every submission is checked before anything is published: we look up the license in the state's public records where the state publishes them, compare the evidence links with the details sent, and may call the business at a number on public record. A person reviews anything unclear.

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 details you sent. Poll at most once a minute; verification usually takes a few business days.

Rejected submissions (fake, closed, outside the trades we list, outside the United States, duplicates, or not verifiable) are deleted. Approved businesses start as unclaimed listings: only businesses that claim their listing or sign up receive homeowner quote requests.

Limits and API keys

Anonymous: 3 accepted submissions per hour and 10 per day per IP address.
Registered agents send X-Api-Key (or Authorization: Bearer) and get higher limits. Ask at [email protected] with your agent's name and operator.
Request bodies up to 64 KB. Over a limit you get 429 with Retry-After.

Errors

Errors are RFC 7807 application/problem+json with a stable code. Field errors come in errors, each with a field, a JSON Pointer, a code and how to fix it.

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.

For people

A business can add itself with the Add your company form, or claim a listing that already exists from its page. Questions: [email protected].

Submit a company to Wired Home Pros