v1.0.0● LIVE10 Jurisdictions

GuardrailUSA Compliance API

Deterministic JSON validation endpoint for Tennessee SB 1580, TIPA, and ELVIS Act compliance tracking. Mitigates $5,000 regulatory penalties to $0 via real-time text and asset auditing. Covers CA AB 2013, TX HB 149, CO SB 205, NY DCWP, FL HB 1459, MA SB 2776, AZ SB 1084, UT SB 149, OR SB 619.

Primary Endpoint

POST/v1/compliance-auditAuth: X-API-Key header

Required Parameters

  • content — string — text or asset description
  • jurisdiction — enum — TN | CA | TX | CO | NY | FL | MA | AZ | UT | OR | ALL

Optional Parameters

  • industry — enum — healthcare | fintech | media | hr | retail | legaltech
  • asset_url — string — audio/video for voice/likeness audit

Response Fields

verdict (GREEN|YELLOW|RED)risk_score (0–100)statutes_triggered[]penalty_exposure_usdremediation[]credits_used

cURL Example

curl -X POST https://api.guardrailusa.com/v1/compliance-audit \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TN_COMPLY_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -d '{
    "content": "Our app clones celebrity voices for personalized ads.",
    "jurisdiction": "TN",
    "industry": "media"
  }'

Sample Response

{
  "verdict": "RED",
  "risk_score": 92,
  "statutes_triggered": [
    "TN ELVIS Act § 47-25-1101 — Voice Cloning",
    "TN TIPA § 47-18-3201 — Biometric Data"
  ],
  "penalty_exposure_usd": 15000,
  "remediation": [
    "Obtain written voice-use consent from each artist",
    "Add opt-in consent flow for biometric data processing",
    "Implement data deletion mechanism"
  ],
  "jurisdiction": "TN",
  "credits_used": 1
}

Python / Agent SDK

import requests

headers = {
    "Content-Type": "application/json",
    "X-API-Key": "TN_COMPLY_XXXXXXXXXXXXXXXXXXXXXXXX"
}

payload = {
    "content": "Our HR tool scores candidates using voice pattern analysis.",
    "jurisdiction": "ALL",
    "industry": "hr"
}

res = requests.post(
    "https://api.guardrailusa.com/v1/compliance-audit",
    json=payload,
    headers=headers
)
print(res.json())

OpenAPI 3.1 Schema (YAML)

openapi: "3.1.0"
info:
  title: GuardrailUSA Compliance API
  version: "1.0.0"
  description: >
    Deterministic JSON validation endpoint for Tennessee SB 1580, TIPA,
    and ELVIS Act compliance tracking. Mitigates $5,000 regulatory penalties
    to $0 via real-time text and asset auditing. Covers 10 US jurisdictions.

servers:
  - url: https://api.guardrailusa.com/v1

security:
  - ApiKeyAuth: []

components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

paths:
  /compliance-audit:
    post:
      summary: Run a compliance audit on text or asset content
      operationId: runComplianceAudit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [content, jurisdiction]
              properties:
                content:
                  type: string
                  description: Text, script, or asset description to audit
                jurisdiction:
                  type: string
                  enum: [TN, CA, TX, CO, NY, FL, MA, AZ, UT, OR, ALL]
                  description: State jurisdiction to audit against
                industry:
                  type: string
                  enum: [healthcare, fintech, media, hr, retail, legaltech]
                  description: Optional industry context for deeper statute matching
                asset_url:
                  type: string
                  description: Optional URL to an audio/video asset for voice/likeness audit
      responses:
        "200":
          description: Compliance verdict
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                    enum: [GREEN, YELLOW, RED]
                  risk_score:
                    type: number
                    minimum: 0
                    maximum: 100
                  statutes_triggered:
                    type: array
                    items:
                      type: string
                  penalty_exposure_usd:
                    type: number
                  remediation:
                    type: array
                    items:
                      type: string
                  jurisdiction:
                    type: string
                  credits_used:
                    type: integer
        "401":
          description: Invalid or missing X-API-Key
        "402":
          description: Insufficient credits
        "429":
          description: Rate limit exceeded

  /account:
    get:
      summary: Retrieve API key account status and credit balance
      operationId: getAccount
      responses:
        "200":
          description: Account object
          content:
            application/json:
              schema:
                type: object
                properties:
                  plan:
                    type: string
                  credits_remaining:
                    type: number
                  usage_count:
                    type: integer
                  status:
                    type: string

HTTP Status Codes

200Audit complete — verdict returned
400Missing required fields or invalid jurisdiction
401Invalid or missing X-API-Key header
402Insufficient credits — upgrade to Agent Fleets Pro
429Rate limit exceeded — 60 req/min on free, unlimited on pro
500Internal error — logged and alerted automatically

Ready to integrate?

Get 100 free audits on the Developer Free Tier — no credit card required.

Get API Key