curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/brand \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "PRIVATE_PROFIT",
    "display_name": "Acme Corp",
    "company_name": "Acme Corporation Inc.",
    "ein": "12-3456789",
    "phone": "+14155551234",
    "street": "1 Market St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US",
    "email": "compliance@acme.com",
    "website": "https://acme.com",
    "vertical": "TECHNOLOGY"
  }'

{
  "data": {
    "brandId": "BXXXXXX",
    "status": "PENDING"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-08T12:00:00Z"
  }
}

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/campaign \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "BXXXXXX",
    "usecase": "CUSTOMER_CARE",
    "description": "Sending order updates and support responses to customers who opted in on our website checkout form.",
    "sample_message": [
      "Your order #12345 has shipped! Track at https://acme.com/track/12345",
      "Hi! Your support ticket #567 has been resolved. Reply STOP to unsubscribe."
    ],
    "message_flow": "Customers opt in via a web form at checkout and confirm consent. They can reply STOP at any time to opt out.",
    "help_message": "Reply HELP for assistance or contact support@acme.com.",
    "optout_message": "You have been unsubscribed and will receive no further messages."
  }'

{
  "data": {
    "campaignId": "CXXXXXX",
    "status": "PENDING"
  },
  "meta": {
    "request_id": "req_def456",
    "timestamp": "2026-03-08T12:05:00Z"
  }
}

curl https://api.orbit.devotel.io/api/v1/compliance/10dlc/campaigns/CXXXXXX/status \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "campaignId": "CXXXXXX",
    "status": "APPROVED",
    "brandId": "BXXXXXX",
    "mnoStatuses": {
      "10017": "APPROVED",
      "10035": "APPROVED",
      "10095": "REVIEW"
    },
    "provider": "telnyx"
  },
  "meta": {
    "request_id": "req_ghi789",
    "timestamp": "2026-03-09T09:00:00Z"
  }
}

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/preflight \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": {
      "display_name": "Acme Corp",
      "entity_type": "PRIVATE_PROFIT",
      "ein": "12-3456789",
      "email": "compliance@acme.com",
      "website": "https://acme.com"
    },
    "campaign": {
      "usecase": "MARKETING",
      "description": "Acme sends weekend promotional offers to customers who opt in on our checkout page.",
      "sample_message": [
        "Acme: 20% off today. Shop at https://bit.ly/acme-sale"
      ],
      "message_flow": "Customers opt in at checkout. They can reply STOP at any time to opt out.",
      "help_message": "Reply HELP for assistance or email support@acme.com.",
      "optout_message": "You are unsubscribed. Reply STOP to opt out.",
      "expected_msg_per_day_per_number": 5000
    },
    "brand_vetting_score": 45
  }'

{
  "data": {
    "score": 61,
    "verdict": "block",
    "findings": [
      {
        "ruleId": "R-CAMP-SAMPLE-SHORTENER",
        "severity": "error",
        "field": "campaign.sample_message[0]",
        "message": "Public URL shortener detected. Carriers auto-reject shortener domains in sample messages.",
        "match": "bit.ly",
        "suggestion": "Replace the shortener with a link on your own domain (e.g. acme.com/sale)."
      },
      {
        "ruleId": "R-CAMP-SAMPLES-COUNT",
        "severity": "warn",
        "field": "campaign.sample_message",
        "message": "Only one sample message provided. TCR vets 2-10 distinct samples covering your real traffic.",
        "suggestion": "Add distinct samples (welcome, reminder, confirmation) so TCR sees the full campaign."
      },
      {
        "ruleId": "R-CAMP-SAMPLE-CTA-STOP",
        "severity": "warn",
        "field": "campaign.sample_message[0]",
        "message": "Sample message does not reference STOP. Carriers expect opt-out wording in at least one sample.",
        "match": "Acme: 20% off today.",
        "suggestion": "Append \"Reply STOP to unsubscribe.\" to the sample."
      },
      {
        "ruleId": "R-CAMP-THROUGHPUT-TIER",
        "severity": "warn",
        "field": "campaign.expected_msg_per_day_per_number",
        "message": "Declared throughput exceeds the daily cap your vetting tier qualifies for.",
        "suggestion": "Lower the declared volume or raise your vetting score to qualify for a higher tier."
      }
    ],
    "engine": "tcr-preflight/v1"
  },
  "meta": {
    "request_id": "req_pf001",
    "timestamp": "2026-08-28T09:00:00Z"
  }
}