Getting Started with AgentVerify

AgentVerify is an evidence-based small-business verification API operated by JARANDA.

1. Get your API key

AgentVerify Beta customers receive an individual API key after their subscription is confirmed. During the beta, API keys are provisioned manually and delivered to the customer.

Keep your API key private. Do not publish it in source code, public repositories, browser-side JavaScript, or documentation.

2. Authentication

Send your API key using the X-API-Key HTTP header.

3. Check your usage

curl \
  -H "X-API-Key: YOUR_API_KEY" \
  https://agentverify-production-dc483.up.railway.app/v1/usage

Your usage response reports the number of verification requests used, your request limit, and the number remaining.

4. Verify a business

curl \
  -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example Plumbing Company",
    "category": "plumbing",
    "city": "San Antonio",
    "state": "TX"
  }' \
  https://agentverify-production-dc483.up.railway.app/v1/verify

5. Understand the response

AgentVerify returns machine-readable information including:

verification status
confidence
coverage
field-level identity results
official-record information when available
conflicts
supporting evidence

Current verification statuses include PROCEED, REVIEW, CAUTION, and HIGH_RISK.

A result of UNKNOWN means evidence was unavailable or inconclusive. It is not automatically negative evidence.

Interactive documentation

Open the AgentVerify API documentation

Beta support

Questions or unexpected verification results can be reported to txagentverify@yahoo.com.

Important notice

AgentVerify provides evidence-based verification signals. It does not certify a business, guarantee trustworthiness, or replace legal, regulatory, financial, safety, or professional due diligence.