[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-twilio-regulatory-compliance-bundles":3,"mdc--k80ais-key":36,"related-org-openai-twilio-regulatory-compliance-bundles":1395,"related-repo-openai-twilio-regulatory-compliance-bundles":1600},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"twilio-regulatory-compliance-bundles","manage Twilio regulatory compliance bundles","Manage regulatory compliance for international phone numbers. Covers what bundles are, which countries require them, how to create End-Users and Supporting Documents, evaluate and submit bundles, fix evaluation failures, update bundles when regulations change, and ISV multi-account patterns. Use this skill when provisioning numbers outside the US.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Operations","operations","tag",{"name":17,"slug":18,"type":15},"Compliance","compliance",{"name":20,"slug":21,"type":15},"Regulatory Compliance","regulatory-compliance",{"name":23,"slug":24,"type":15},"Twilio","twilio",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Ftwilio-developer-kit\u002Fskills\u002Ftwilio-regulatory-compliance-bundles","---\nname: twilio-regulatory-compliance-bundles\ndescription: >\n  Manage regulatory compliance for international phone numbers. Covers\n  what bundles are, which countries require them, how to create End-Users\n  and Supporting Documents, evaluate and submit bundles, fix evaluation\n  failures, update bundles when regulations change, and ISV multi-account\n  patterns. Use this skill when provisioning numbers outside the US.\n---\n\n## Overview\n\nPhone numbers are national resources — many countries require **identity verification of the end-user** before provisioning. A Regulatory Bundle is a container holding an End-User record + Supporting Documents that proves your right to use numbers in a specific country.\n\n**Not all countries require bundles** — check the [Regulatory Guidelines page](https:\u002F\u002Fwww.twilio.com\u002Fen-us\u002Fguidelines\u002Fregulatory) for country-specific requirements. If a country requires a bundle, provisioning fails without one.\n\n---\n\n## Key Concepts\n\n| Resource | What it is |\n|----------|-----------|\n| **Regulation** | Country-specific requirement defining what End-User types and document types are needed |\n| **Bundle** | Container that holds an End-User + Supporting Documents for a specific regulation |\n| **End-User** | The entity answering calls or receiving messages (`individual` or `business` type) |\n| **Supporting Document** | Identity\u002Faddress verification documents (business registration, proof of address, etc.) |\n| **Evaluation** | Synchronous check that validates a bundle against its regulation before submission |\n| **Item Assignment** | Links an End-User or Supporting Document to a Bundle |\n\n---\n\n## Quickstart: Provision a Number with a Bundle\n\n### Step 1 — Query the Regulation\n\nFind out what's required for the country and number type:\n\n**Python**\n```python\nimport os, requests\n\naccount_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\nauth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n\n# What does Germany require for local business numbers?\nregulations = requests.get(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FRegulations\",\n    params={\"IsoCountry\": \"DE\", \"NumberType\": \"local\", \"EndUserType\": \"business\"},\n    auth=(account_sid, auth_token)\n).json()\n\nfor reg in regulations[\"results\"]:\n    print(f\"Regulation: {reg['sid']}\")\n    print(f\"Requirements: {reg['requirements']}\")\n```\n\n### Step 2 — Create an End-User\n\n**Python**\n```python\nend_user = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FEndUsers\",\n    data={\n        \"FriendlyName\": \"Acme GmbH\",\n        \"Type\": \"business\",\n        \"Attributes\": '{\"business_name\": \"Acme GmbH\", \"business_registration_number\": \"HRB12345\"}'\n    },\n    auth=(account_sid, auth_token)\n).json()\n```\n\n### Step 3 — Upload Supporting Documents\n\n**Python**\n```python\ndocument = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FSupportingDocuments\",\n    data={\n        \"FriendlyName\": \"Acme Business Registration\",\n        \"Type\": \"business_registration\",\n        \"Attributes\": '{\"business_name\": \"Acme GmbH\"}'\n    },\n    auth=(account_sid, auth_token)\n).json()\n```\n\n### Step 4 — Create a Bundle and Assign Items\n\n**Python**\n```python\n# Create the bundle\nbundle = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\",\n    data={\n        \"FriendlyName\": \"Germany Local - Acme\",\n        \"RegulationSid\": regulations[\"results\"][0][\"sid\"],\n        \"IsoCountry\": \"DE\",\n        \"EndUserType\": \"business\",\n        \"Email\": \"compliance@acme.com\"\n    },\n    auth=(account_sid, auth_token)\n).json()\n\nbundle_sid = bundle[\"sid\"]\n\n# Assign End-User to bundle\nrequests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FItemAssignments\",\n    data={\"ObjectSid\": end_user[\"sid\"]},\n    auth=(account_sid, auth_token)\n)\n\n# Assign Supporting Document to bundle\nrequests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FItemAssignments\",\n    data={\"ObjectSid\": document[\"sid\"]},\n    auth=(account_sid, auth_token)\n)\n```\n\n### Step 5 — Evaluate and Submit\n\n**Python**\n```python\n# Run evaluation (synchronous — returns field-level failures)\nevaluation = requests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FEvaluations\",\n    auth=(account_sid, auth_token)\n).json()\n\nif evaluation[\"status\"] == \"noncompliant\":\n    for violation in evaluation[\"results\"]:\n        print(f\"Field: {violation['friendly_name']} — {violation['description']}\")\n    # Fix the issues, then re-evaluate\nelse:\n    # Submit for review\n    requests.post(\n        f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\",\n        data={\"Status\": \"pending-review\"},\n        auth=(account_sid, auth_token)\n    )\n```\n\n### Step 6 — Provision Number with Bundle\n\nOnce the bundle is approved:\n\n**Python**\n```python\nfrom twilio.rest import Client\nclient = Client(account_sid, auth_token)\n\nnumber = client.incoming_phone_numbers.create(\n    phone_number=\"+4930xxxxxxx\",\n    bundle_sid=bundle_sid\n)\n```\n\n---\n\n## Updating an Approved Bundle\n\nWhen regulations change, you'll receive an email. Update without deprovisioning numbers:\n\n1. **Copy** the approved bundle into a mutable state via the Bundle Copies resource\n2. **Update** the End-User or Supporting Document on the copy\n3. **Re-evaluate** the copy\n4. **Replace** items in the original bundle via the Replace Items resource\n\nPhone numbers remain provisioned throughout this process.\n\n**Alternative:** Create a new bundle → get it approved → remap numbers to the new bundle.\n\n**Docs:** [Bundle Copies](https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-copies) | [Replace Items](https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-replace-items)\n\n---\n\n## ISV \u002F Multi-Account Pattern\n\nIf managing Twilio subaccounts for multiple customers:\n\n- **Each customer needs their own bundle** — Do not reuse your business information in customer bundles\n- Use the **Bundle Clones** resource to duplicate bundle structures across subaccounts\n- End-User records must reflect the actual end-user (your customer), not you\n\n**Docs:** [Bundle Clones](https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-clones)\n\n---\n\n## CANNOT\n\n- **Cannot provision numbers without required bundles** — Provisioning fails immediately. Check Regulations resource first.\n- **Cannot reuse one bundle across different number types** — Each bundle is tied to a specific regulation (country + number type + end-user type).\n- **Locality-matching addresses required in ~33 countries** — Germany (and others) require the End-User address to be within the region of the phone number prefix, not just any address in the country. US HQ address will fail for a Berlin number.\n- **Cannot hardcode regulation requirements** — Regulations change periodically. Always query the Regulations resource dynamically.\n- **Do not create a new bundle when evaluation fails** — Fix the existing bundle. Creating new ones wastes time and clutters your account.\n- **Cannot reuse your ISV info in customer bundles** — Bundles must represent the actual end-user. Twilio audits this.\n- **Some markets are business-only** — Individual provisioning not allowed. Check the `EndUserType` in the Regulation.\n\n---\n\n## Next Steps\n\n- **Choose number type before provisioning:** `twilio-numbers-senders`\n- **Register numbers after provisioning:** `twilio-compliance-onboarding`\n- **Country-specific requirements:** [Regulatory Guidelines](https:\u002F\u002Fwww.twilio.com\u002Fen-us\u002Fguidelines\u002Fregulatory)\n- **API reference:** [Regulatory Compliance API](https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi)\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,50,64,85,89,95,236,239,245,252,257,265,412,418,425,502,508,515,590,596,603,835,841,848,988,994,999,1006,1067,1070,1076,1081,1126,1131,1141,1167,1170,1176,1181,1212,1226,1229,1235,1316,1319,1325,1389],{"type":42,"tag":43,"props":44,"children":46},"element","h2",{"id":45},"overview",[47],{"type":48,"value":49},"text","Overview",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54,56,62],{"type":48,"value":55},"Phone numbers are national resources — many countries require ",{"type":42,"tag":57,"props":58,"children":59},"strong",{},[60],{"type":48,"value":61},"identity verification of the end-user",{"type":48,"value":63}," before provisioning. A Regulatory Bundle is a container holding an End-User record + Supporting Documents that proves your right to use numbers in a specific country.",{"type":42,"tag":51,"props":65,"children":66},{},[67,72,74,83],{"type":42,"tag":57,"props":68,"children":69},{},[70],{"type":48,"value":71},"Not all countries require bundles",{"type":48,"value":73}," — check the ",{"type":42,"tag":75,"props":76,"children":80},"a",{"href":77,"rel":78},"https:\u002F\u002Fwww.twilio.com\u002Fen-us\u002Fguidelines\u002Fregulatory",[79],"nofollow",[81],{"type":48,"value":82},"Regulatory Guidelines page",{"type":48,"value":84}," for country-specific requirements. If a country requires a bundle, provisioning fails without one.",{"type":42,"tag":86,"props":87,"children":88},"hr",{},[],{"type":42,"tag":43,"props":90,"children":92},{"id":91},"key-concepts",[93],{"type":48,"value":94},"Key Concepts",{"type":42,"tag":96,"props":97,"children":98},"table",{},[99,118],{"type":42,"tag":100,"props":101,"children":102},"thead",{},[103],{"type":42,"tag":104,"props":105,"children":106},"tr",{},[107,113],{"type":42,"tag":108,"props":109,"children":110},"th",{},[111],{"type":48,"value":112},"Resource",{"type":42,"tag":108,"props":114,"children":115},{},[116],{"type":48,"value":117},"What it is",{"type":42,"tag":119,"props":120,"children":121},"tbody",{},[122,139,155,188,204,220],{"type":42,"tag":104,"props":123,"children":124},{},[125,134],{"type":42,"tag":126,"props":127,"children":128},"td",{},[129],{"type":42,"tag":57,"props":130,"children":131},{},[132],{"type":48,"value":133},"Regulation",{"type":42,"tag":126,"props":135,"children":136},{},[137],{"type":48,"value":138},"Country-specific requirement defining what End-User types and document types are needed",{"type":42,"tag":104,"props":140,"children":141},{},[142,150],{"type":42,"tag":126,"props":143,"children":144},{},[145],{"type":42,"tag":57,"props":146,"children":147},{},[148],{"type":48,"value":149},"Bundle",{"type":42,"tag":126,"props":151,"children":152},{},[153],{"type":48,"value":154},"Container that holds an End-User + Supporting Documents for a specific regulation",{"type":42,"tag":104,"props":156,"children":157},{},[158,166],{"type":42,"tag":126,"props":159,"children":160},{},[161],{"type":42,"tag":57,"props":162,"children":163},{},[164],{"type":48,"value":165},"End-User",{"type":42,"tag":126,"props":167,"children":168},{},[169,171,178,180,186],{"type":48,"value":170},"The entity answering calls or receiving messages (",{"type":42,"tag":172,"props":173,"children":175},"code",{"className":174},[],[176],{"type":48,"value":177},"individual",{"type":48,"value":179}," or ",{"type":42,"tag":172,"props":181,"children":183},{"className":182},[],[184],{"type":48,"value":185},"business",{"type":48,"value":187}," type)",{"type":42,"tag":104,"props":189,"children":190},{},[191,199],{"type":42,"tag":126,"props":192,"children":193},{},[194],{"type":42,"tag":57,"props":195,"children":196},{},[197],{"type":48,"value":198},"Supporting Document",{"type":42,"tag":126,"props":200,"children":201},{},[202],{"type":48,"value":203},"Identity\u002Faddress verification documents (business registration, proof of address, etc.)",{"type":42,"tag":104,"props":205,"children":206},{},[207,215],{"type":42,"tag":126,"props":208,"children":209},{},[210],{"type":42,"tag":57,"props":211,"children":212},{},[213],{"type":48,"value":214},"Evaluation",{"type":42,"tag":126,"props":216,"children":217},{},[218],{"type":48,"value":219},"Synchronous check that validates a bundle against its regulation before submission",{"type":42,"tag":104,"props":221,"children":222},{},[223,231],{"type":42,"tag":126,"props":224,"children":225},{},[226],{"type":42,"tag":57,"props":227,"children":228},{},[229],{"type":48,"value":230},"Item Assignment",{"type":42,"tag":126,"props":232,"children":233},{},[234],{"type":48,"value":235},"Links an End-User or Supporting Document to a Bundle",{"type":42,"tag":86,"props":237,"children":238},{},[],{"type":42,"tag":43,"props":240,"children":242},{"id":241},"quickstart-provision-a-number-with-a-bundle",[243],{"type":48,"value":244},"Quickstart: Provision a Number with a Bundle",{"type":42,"tag":246,"props":247,"children":249},"h3",{"id":248},"step-1-query-the-regulation",[250],{"type":48,"value":251},"Step 1 — Query the Regulation",{"type":42,"tag":51,"props":253,"children":254},{},[255],{"type":48,"value":256},"Find out what's required for the country and number type:",{"type":42,"tag":51,"props":258,"children":259},{},[260],{"type":42,"tag":57,"props":261,"children":262},{},[263],{"type":48,"value":264},"Python",{"type":42,"tag":266,"props":267,"children":272},"pre",{"className":268,"code":269,"language":270,"meta":271,"style":271},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os, requests\n\naccount_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\nauth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n\n# What does Germany require for local business numbers?\nregulations = requests.get(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FRegulations\",\n    params={\"IsoCountry\": \"DE\", \"NumberType\": \"local\", \"EndUserType\": \"business\"},\n    auth=(account_sid, auth_token)\n).json()\n\nfor reg in regulations[\"results\"]:\n    print(f\"Regulation: {reg['sid']}\")\n    print(f\"Requirements: {reg['requirements']}\")\n","python","",[273],{"type":42,"tag":172,"props":274,"children":275},{"__ignoreMap":271},[276,287,297,306,315,323,332,341,350,359,368,377,385,394,403],{"type":42,"tag":277,"props":278,"children":281},"span",{"class":279,"line":280},"line",1,[282],{"type":42,"tag":277,"props":283,"children":284},{},[285],{"type":48,"value":286},"import os, requests\n",{"type":42,"tag":277,"props":288,"children":290},{"class":279,"line":289},2,[291],{"type":42,"tag":277,"props":292,"children":294},{"emptyLinePlaceholder":293},true,[295],{"type":48,"value":296},"\n",{"type":42,"tag":277,"props":298,"children":300},{"class":279,"line":299},3,[301],{"type":42,"tag":277,"props":302,"children":303},{},[304],{"type":48,"value":305},"account_sid = os.environ[\"TWILIO_ACCOUNT_SID\"]\n",{"type":42,"tag":277,"props":307,"children":309},{"class":279,"line":308},4,[310],{"type":42,"tag":277,"props":311,"children":312},{},[313],{"type":48,"value":314},"auth_token = os.environ[\"TWILIO_AUTH_TOKEN\"]\n",{"type":42,"tag":277,"props":316,"children":318},{"class":279,"line":317},5,[319],{"type":42,"tag":277,"props":320,"children":321},{"emptyLinePlaceholder":293},[322],{"type":48,"value":296},{"type":42,"tag":277,"props":324,"children":326},{"class":279,"line":325},6,[327],{"type":42,"tag":277,"props":328,"children":329},{},[330],{"type":48,"value":331},"# What does Germany require for local business numbers?\n",{"type":42,"tag":277,"props":333,"children":335},{"class":279,"line":334},7,[336],{"type":42,"tag":277,"props":337,"children":338},{},[339],{"type":48,"value":340},"regulations = requests.get(\n",{"type":42,"tag":277,"props":342,"children":344},{"class":279,"line":343},8,[345],{"type":42,"tag":277,"props":346,"children":347},{},[348],{"type":48,"value":349},"    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FRegulations\",\n",{"type":42,"tag":277,"props":351,"children":353},{"class":279,"line":352},9,[354],{"type":42,"tag":277,"props":355,"children":356},{},[357],{"type":48,"value":358},"    params={\"IsoCountry\": \"DE\", \"NumberType\": \"local\", \"EndUserType\": \"business\"},\n",{"type":42,"tag":277,"props":360,"children":362},{"class":279,"line":361},10,[363],{"type":42,"tag":277,"props":364,"children":365},{},[366],{"type":48,"value":367},"    auth=(account_sid, auth_token)\n",{"type":42,"tag":277,"props":369,"children":371},{"class":279,"line":370},11,[372],{"type":42,"tag":277,"props":373,"children":374},{},[375],{"type":48,"value":376},").json()\n",{"type":42,"tag":277,"props":378,"children":380},{"class":279,"line":379},12,[381],{"type":42,"tag":277,"props":382,"children":383},{"emptyLinePlaceholder":293},[384],{"type":48,"value":296},{"type":42,"tag":277,"props":386,"children":388},{"class":279,"line":387},13,[389],{"type":42,"tag":277,"props":390,"children":391},{},[392],{"type":48,"value":393},"for reg in regulations[\"results\"]:\n",{"type":42,"tag":277,"props":395,"children":397},{"class":279,"line":396},14,[398],{"type":42,"tag":277,"props":399,"children":400},{},[401],{"type":48,"value":402},"    print(f\"Regulation: {reg['sid']}\")\n",{"type":42,"tag":277,"props":404,"children":406},{"class":279,"line":405},15,[407],{"type":42,"tag":277,"props":408,"children":409},{},[410],{"type":48,"value":411},"    print(f\"Requirements: {reg['requirements']}\")\n",{"type":42,"tag":246,"props":413,"children":415},{"id":414},"step-2-create-an-end-user",[416],{"type":48,"value":417},"Step 2 — Create an End-User",{"type":42,"tag":51,"props":419,"children":420},{},[421],{"type":42,"tag":57,"props":422,"children":423},{},[424],{"type":48,"value":264},{"type":42,"tag":266,"props":426,"children":428},{"className":268,"code":427,"language":270,"meta":271,"style":271},"end_user = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FEndUsers\",\n    data={\n        \"FriendlyName\": \"Acme GmbH\",\n        \"Type\": \"business\",\n        \"Attributes\": '{\"business_name\": \"Acme GmbH\", \"business_registration_number\": \"HRB12345\"}'\n    },\n    auth=(account_sid, auth_token)\n).json()\n",[429],{"type":42,"tag":172,"props":430,"children":431},{"__ignoreMap":271},[432,440,448,456,464,472,480,488,495],{"type":42,"tag":277,"props":433,"children":434},{"class":279,"line":280},[435],{"type":42,"tag":277,"props":436,"children":437},{},[438],{"type":48,"value":439},"end_user = requests.post(\n",{"type":42,"tag":277,"props":441,"children":442},{"class":279,"line":289},[443],{"type":42,"tag":277,"props":444,"children":445},{},[446],{"type":48,"value":447},"    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FEndUsers\",\n",{"type":42,"tag":277,"props":449,"children":450},{"class":279,"line":299},[451],{"type":42,"tag":277,"props":452,"children":453},{},[454],{"type":48,"value":455},"    data={\n",{"type":42,"tag":277,"props":457,"children":458},{"class":279,"line":308},[459],{"type":42,"tag":277,"props":460,"children":461},{},[462],{"type":48,"value":463},"        \"FriendlyName\": \"Acme GmbH\",\n",{"type":42,"tag":277,"props":465,"children":466},{"class":279,"line":317},[467],{"type":42,"tag":277,"props":468,"children":469},{},[470],{"type":48,"value":471},"        \"Type\": \"business\",\n",{"type":42,"tag":277,"props":473,"children":474},{"class":279,"line":325},[475],{"type":42,"tag":277,"props":476,"children":477},{},[478],{"type":48,"value":479},"        \"Attributes\": '{\"business_name\": \"Acme GmbH\", \"business_registration_number\": \"HRB12345\"}'\n",{"type":42,"tag":277,"props":481,"children":482},{"class":279,"line":334},[483],{"type":42,"tag":277,"props":484,"children":485},{},[486],{"type":48,"value":487},"    },\n",{"type":42,"tag":277,"props":489,"children":490},{"class":279,"line":343},[491],{"type":42,"tag":277,"props":492,"children":493},{},[494],{"type":48,"value":367},{"type":42,"tag":277,"props":496,"children":497},{"class":279,"line":352},[498],{"type":42,"tag":277,"props":499,"children":500},{},[501],{"type":48,"value":376},{"type":42,"tag":246,"props":503,"children":505},{"id":504},"step-3-upload-supporting-documents",[506],{"type":48,"value":507},"Step 3 — Upload Supporting Documents",{"type":42,"tag":51,"props":509,"children":510},{},[511],{"type":42,"tag":57,"props":512,"children":513},{},[514],{"type":48,"value":264},{"type":42,"tag":266,"props":516,"children":518},{"className":268,"code":517,"language":270,"meta":271,"style":271},"document = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FSupportingDocuments\",\n    data={\n        \"FriendlyName\": \"Acme Business Registration\",\n        \"Type\": \"business_registration\",\n        \"Attributes\": '{\"business_name\": \"Acme GmbH\"}'\n    },\n    auth=(account_sid, auth_token)\n).json()\n",[519],{"type":42,"tag":172,"props":520,"children":521},{"__ignoreMap":271},[522,530,538,545,553,561,569,576,583],{"type":42,"tag":277,"props":523,"children":524},{"class":279,"line":280},[525],{"type":42,"tag":277,"props":526,"children":527},{},[528],{"type":48,"value":529},"document = requests.post(\n",{"type":42,"tag":277,"props":531,"children":532},{"class":279,"line":289},[533],{"type":42,"tag":277,"props":534,"children":535},{},[536],{"type":48,"value":537},"    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FSupportingDocuments\",\n",{"type":42,"tag":277,"props":539,"children":540},{"class":279,"line":299},[541],{"type":42,"tag":277,"props":542,"children":543},{},[544],{"type":48,"value":455},{"type":42,"tag":277,"props":546,"children":547},{"class":279,"line":308},[548],{"type":42,"tag":277,"props":549,"children":550},{},[551],{"type":48,"value":552},"        \"FriendlyName\": \"Acme Business Registration\",\n",{"type":42,"tag":277,"props":554,"children":555},{"class":279,"line":317},[556],{"type":42,"tag":277,"props":557,"children":558},{},[559],{"type":48,"value":560},"        \"Type\": \"business_registration\",\n",{"type":42,"tag":277,"props":562,"children":563},{"class":279,"line":325},[564],{"type":42,"tag":277,"props":565,"children":566},{},[567],{"type":48,"value":568},"        \"Attributes\": '{\"business_name\": \"Acme GmbH\"}'\n",{"type":42,"tag":277,"props":570,"children":571},{"class":279,"line":334},[572],{"type":42,"tag":277,"props":573,"children":574},{},[575],{"type":48,"value":487},{"type":42,"tag":277,"props":577,"children":578},{"class":279,"line":343},[579],{"type":42,"tag":277,"props":580,"children":581},{},[582],{"type":48,"value":367},{"type":42,"tag":277,"props":584,"children":585},{"class":279,"line":352},[586],{"type":42,"tag":277,"props":587,"children":588},{},[589],{"type":48,"value":376},{"type":42,"tag":246,"props":591,"children":593},{"id":592},"step-4-create-a-bundle-and-assign-items",[594],{"type":48,"value":595},"Step 4 — Create a Bundle and Assign Items",{"type":42,"tag":51,"props":597,"children":598},{},[599],{"type":42,"tag":57,"props":600,"children":601},{},[602],{"type":48,"value":264},{"type":42,"tag":266,"props":604,"children":606},{"className":268,"code":605,"language":270,"meta":271,"style":271},"# Create the bundle\nbundle = requests.post(\n    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\",\n    data={\n        \"FriendlyName\": \"Germany Local - Acme\",\n        \"RegulationSid\": regulations[\"results\"][0][\"sid\"],\n        \"IsoCountry\": \"DE\",\n        \"EndUserType\": \"business\",\n        \"Email\": \"compliance@acme.com\"\n    },\n    auth=(account_sid, auth_token)\n).json()\n\nbundle_sid = bundle[\"sid\"]\n\n# Assign End-User to bundle\nrequests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FItemAssignments\",\n    data={\"ObjectSid\": end_user[\"sid\"]},\n    auth=(account_sid, auth_token)\n)\n\n# Assign Supporting Document to bundle\nrequests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FItemAssignments\",\n    data={\"ObjectSid\": document[\"sid\"]},\n    auth=(account_sid, auth_token)\n)\n",[607],{"type":42,"tag":172,"props":608,"children":609},{"__ignoreMap":271},[610,618,626,634,641,649,657,665,673,681,688,695,702,709,717,724,733,742,751,760,768,777,785,794,802,810,819,827],{"type":42,"tag":277,"props":611,"children":612},{"class":279,"line":280},[613],{"type":42,"tag":277,"props":614,"children":615},{},[616],{"type":48,"value":617},"# Create the bundle\n",{"type":42,"tag":277,"props":619,"children":620},{"class":279,"line":289},[621],{"type":42,"tag":277,"props":622,"children":623},{},[624],{"type":48,"value":625},"bundle = requests.post(\n",{"type":42,"tag":277,"props":627,"children":628},{"class":279,"line":299},[629],{"type":42,"tag":277,"props":630,"children":631},{},[632],{"type":48,"value":633},"    \"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\",\n",{"type":42,"tag":277,"props":635,"children":636},{"class":279,"line":308},[637],{"type":42,"tag":277,"props":638,"children":639},{},[640],{"type":48,"value":455},{"type":42,"tag":277,"props":642,"children":643},{"class":279,"line":317},[644],{"type":42,"tag":277,"props":645,"children":646},{},[647],{"type":48,"value":648},"        \"FriendlyName\": \"Germany Local - Acme\",\n",{"type":42,"tag":277,"props":650,"children":651},{"class":279,"line":325},[652],{"type":42,"tag":277,"props":653,"children":654},{},[655],{"type":48,"value":656},"        \"RegulationSid\": regulations[\"results\"][0][\"sid\"],\n",{"type":42,"tag":277,"props":658,"children":659},{"class":279,"line":334},[660],{"type":42,"tag":277,"props":661,"children":662},{},[663],{"type":48,"value":664},"        \"IsoCountry\": \"DE\",\n",{"type":42,"tag":277,"props":666,"children":667},{"class":279,"line":343},[668],{"type":42,"tag":277,"props":669,"children":670},{},[671],{"type":48,"value":672},"        \"EndUserType\": \"business\",\n",{"type":42,"tag":277,"props":674,"children":675},{"class":279,"line":352},[676],{"type":42,"tag":277,"props":677,"children":678},{},[679],{"type":48,"value":680},"        \"Email\": \"compliance@acme.com\"\n",{"type":42,"tag":277,"props":682,"children":683},{"class":279,"line":361},[684],{"type":42,"tag":277,"props":685,"children":686},{},[687],{"type":48,"value":487},{"type":42,"tag":277,"props":689,"children":690},{"class":279,"line":370},[691],{"type":42,"tag":277,"props":692,"children":693},{},[694],{"type":48,"value":367},{"type":42,"tag":277,"props":696,"children":697},{"class":279,"line":379},[698],{"type":42,"tag":277,"props":699,"children":700},{},[701],{"type":48,"value":376},{"type":42,"tag":277,"props":703,"children":704},{"class":279,"line":387},[705],{"type":42,"tag":277,"props":706,"children":707},{"emptyLinePlaceholder":293},[708],{"type":48,"value":296},{"type":42,"tag":277,"props":710,"children":711},{"class":279,"line":396},[712],{"type":42,"tag":277,"props":713,"children":714},{},[715],{"type":48,"value":716},"bundle_sid = bundle[\"sid\"]\n",{"type":42,"tag":277,"props":718,"children":719},{"class":279,"line":405},[720],{"type":42,"tag":277,"props":721,"children":722},{"emptyLinePlaceholder":293},[723],{"type":48,"value":296},{"type":42,"tag":277,"props":725,"children":727},{"class":279,"line":726},16,[728],{"type":42,"tag":277,"props":729,"children":730},{},[731],{"type":48,"value":732},"# Assign End-User to bundle\n",{"type":42,"tag":277,"props":734,"children":736},{"class":279,"line":735},17,[737],{"type":42,"tag":277,"props":738,"children":739},{},[740],{"type":48,"value":741},"requests.post(\n",{"type":42,"tag":277,"props":743,"children":745},{"class":279,"line":744},18,[746],{"type":42,"tag":277,"props":747,"children":748},{},[749],{"type":48,"value":750},"    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FItemAssignments\",\n",{"type":42,"tag":277,"props":752,"children":754},{"class":279,"line":753},19,[755],{"type":42,"tag":277,"props":756,"children":757},{},[758],{"type":48,"value":759},"    data={\"ObjectSid\": end_user[\"sid\"]},\n",{"type":42,"tag":277,"props":761,"children":763},{"class":279,"line":762},20,[764],{"type":42,"tag":277,"props":765,"children":766},{},[767],{"type":48,"value":367},{"type":42,"tag":277,"props":769,"children":771},{"class":279,"line":770},21,[772],{"type":42,"tag":277,"props":773,"children":774},{},[775],{"type":48,"value":776},")\n",{"type":42,"tag":277,"props":778,"children":780},{"class":279,"line":779},22,[781],{"type":42,"tag":277,"props":782,"children":783},{"emptyLinePlaceholder":293},[784],{"type":48,"value":296},{"type":42,"tag":277,"props":786,"children":788},{"class":279,"line":787},23,[789],{"type":42,"tag":277,"props":790,"children":791},{},[792],{"type":48,"value":793},"# Assign Supporting Document to bundle\n",{"type":42,"tag":277,"props":795,"children":797},{"class":279,"line":796},24,[798],{"type":42,"tag":277,"props":799,"children":800},{},[801],{"type":48,"value":741},{"type":42,"tag":277,"props":803,"children":805},{"class":279,"line":804},25,[806],{"type":42,"tag":277,"props":807,"children":808},{},[809],{"type":48,"value":750},{"type":42,"tag":277,"props":811,"children":813},{"class":279,"line":812},26,[814],{"type":42,"tag":277,"props":815,"children":816},{},[817],{"type":48,"value":818},"    data={\"ObjectSid\": document[\"sid\"]},\n",{"type":42,"tag":277,"props":820,"children":822},{"class":279,"line":821},27,[823],{"type":42,"tag":277,"props":824,"children":825},{},[826],{"type":48,"value":367},{"type":42,"tag":277,"props":828,"children":830},{"class":279,"line":829},28,[831],{"type":42,"tag":277,"props":832,"children":833},{},[834],{"type":48,"value":776},{"type":42,"tag":246,"props":836,"children":838},{"id":837},"step-5-evaluate-and-submit",[839],{"type":48,"value":840},"Step 5 — Evaluate and Submit",{"type":42,"tag":51,"props":842,"children":843},{},[844],{"type":42,"tag":57,"props":845,"children":846},{},[847],{"type":48,"value":264},{"type":42,"tag":266,"props":849,"children":851},{"className":268,"code":850,"language":270,"meta":271,"style":271},"# Run evaluation (synchronous — returns field-level failures)\nevaluation = requests.post(\n    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FEvaluations\",\n    auth=(account_sid, auth_token)\n).json()\n\nif evaluation[\"status\"] == \"noncompliant\":\n    for violation in evaluation[\"results\"]:\n        print(f\"Field: {violation['friendly_name']} — {violation['description']}\")\n    # Fix the issues, then re-evaluate\nelse:\n    # Submit for review\n    requests.post(\n        f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\",\n        data={\"Status\": \"pending-review\"},\n        auth=(account_sid, auth_token)\n    )\n",[852],{"type":42,"tag":172,"props":853,"children":854},{"__ignoreMap":271},[855,863,871,879,886,893,900,908,916,924,932,940,948,956,964,972,980],{"type":42,"tag":277,"props":856,"children":857},{"class":279,"line":280},[858],{"type":42,"tag":277,"props":859,"children":860},{},[861],{"type":48,"value":862},"# Run evaluation (synchronous — returns field-level failures)\n",{"type":42,"tag":277,"props":864,"children":865},{"class":279,"line":289},[866],{"type":42,"tag":277,"props":867,"children":868},{},[869],{"type":48,"value":870},"evaluation = requests.post(\n",{"type":42,"tag":277,"props":872,"children":873},{"class":279,"line":299},[874],{"type":42,"tag":277,"props":875,"children":876},{},[877],{"type":48,"value":878},"    f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\u002FEvaluations\",\n",{"type":42,"tag":277,"props":880,"children":881},{"class":279,"line":308},[882],{"type":42,"tag":277,"props":883,"children":884},{},[885],{"type":48,"value":367},{"type":42,"tag":277,"props":887,"children":888},{"class":279,"line":317},[889],{"type":42,"tag":277,"props":890,"children":891},{},[892],{"type":48,"value":376},{"type":42,"tag":277,"props":894,"children":895},{"class":279,"line":325},[896],{"type":42,"tag":277,"props":897,"children":898},{"emptyLinePlaceholder":293},[899],{"type":48,"value":296},{"type":42,"tag":277,"props":901,"children":902},{"class":279,"line":334},[903],{"type":42,"tag":277,"props":904,"children":905},{},[906],{"type":48,"value":907},"if evaluation[\"status\"] == \"noncompliant\":\n",{"type":42,"tag":277,"props":909,"children":910},{"class":279,"line":343},[911],{"type":42,"tag":277,"props":912,"children":913},{},[914],{"type":48,"value":915},"    for violation in evaluation[\"results\"]:\n",{"type":42,"tag":277,"props":917,"children":918},{"class":279,"line":352},[919],{"type":42,"tag":277,"props":920,"children":921},{},[922],{"type":48,"value":923},"        print(f\"Field: {violation['friendly_name']} — {violation['description']}\")\n",{"type":42,"tag":277,"props":925,"children":926},{"class":279,"line":361},[927],{"type":42,"tag":277,"props":928,"children":929},{},[930],{"type":48,"value":931},"    # Fix the issues, then re-evaluate\n",{"type":42,"tag":277,"props":933,"children":934},{"class":279,"line":370},[935],{"type":42,"tag":277,"props":936,"children":937},{},[938],{"type":48,"value":939},"else:\n",{"type":42,"tag":277,"props":941,"children":942},{"class":279,"line":379},[943],{"type":42,"tag":277,"props":944,"children":945},{},[946],{"type":48,"value":947},"    # Submit for review\n",{"type":42,"tag":277,"props":949,"children":950},{"class":279,"line":387},[951],{"type":42,"tag":277,"props":952,"children":953},{},[954],{"type":48,"value":955},"    requests.post(\n",{"type":42,"tag":277,"props":957,"children":958},{"class":279,"line":396},[959],{"type":42,"tag":277,"props":960,"children":961},{},[962],{"type":48,"value":963},"        f\"https:\u002F\u002Fnumbers.twilio.com\u002Fv2\u002FRegulatoryCompliance\u002FBundles\u002F{bundle_sid}\",\n",{"type":42,"tag":277,"props":965,"children":966},{"class":279,"line":405},[967],{"type":42,"tag":277,"props":968,"children":969},{},[970],{"type":48,"value":971},"        data={\"Status\": \"pending-review\"},\n",{"type":42,"tag":277,"props":973,"children":974},{"class":279,"line":726},[975],{"type":42,"tag":277,"props":976,"children":977},{},[978],{"type":48,"value":979},"        auth=(account_sid, auth_token)\n",{"type":42,"tag":277,"props":981,"children":982},{"class":279,"line":735},[983],{"type":42,"tag":277,"props":984,"children":985},{},[986],{"type":48,"value":987},"    )\n",{"type":42,"tag":246,"props":989,"children":991},{"id":990},"step-6-provision-number-with-bundle",[992],{"type":48,"value":993},"Step 6 — Provision Number with Bundle",{"type":42,"tag":51,"props":995,"children":996},{},[997],{"type":48,"value":998},"Once the bundle is approved:",{"type":42,"tag":51,"props":1000,"children":1001},{},[1002],{"type":42,"tag":57,"props":1003,"children":1004},{},[1005],{"type":48,"value":264},{"type":42,"tag":266,"props":1007,"children":1009},{"className":268,"code":1008,"language":270,"meta":271,"style":271},"from twilio.rest import Client\nclient = Client(account_sid, auth_token)\n\nnumber = client.incoming_phone_numbers.create(\n    phone_number=\"+4930xxxxxxx\",\n    bundle_sid=bundle_sid\n)\n",[1010],{"type":42,"tag":172,"props":1011,"children":1012},{"__ignoreMap":271},[1013,1021,1029,1036,1044,1052,1060],{"type":42,"tag":277,"props":1014,"children":1015},{"class":279,"line":280},[1016],{"type":42,"tag":277,"props":1017,"children":1018},{},[1019],{"type":48,"value":1020},"from twilio.rest import Client\n",{"type":42,"tag":277,"props":1022,"children":1023},{"class":279,"line":289},[1024],{"type":42,"tag":277,"props":1025,"children":1026},{},[1027],{"type":48,"value":1028},"client = Client(account_sid, auth_token)\n",{"type":42,"tag":277,"props":1030,"children":1031},{"class":279,"line":299},[1032],{"type":42,"tag":277,"props":1033,"children":1034},{"emptyLinePlaceholder":293},[1035],{"type":48,"value":296},{"type":42,"tag":277,"props":1037,"children":1038},{"class":279,"line":308},[1039],{"type":42,"tag":277,"props":1040,"children":1041},{},[1042],{"type":48,"value":1043},"number = client.incoming_phone_numbers.create(\n",{"type":42,"tag":277,"props":1045,"children":1046},{"class":279,"line":317},[1047],{"type":42,"tag":277,"props":1048,"children":1049},{},[1050],{"type":48,"value":1051},"    phone_number=\"+4930xxxxxxx\",\n",{"type":42,"tag":277,"props":1053,"children":1054},{"class":279,"line":325},[1055],{"type":42,"tag":277,"props":1056,"children":1057},{},[1058],{"type":48,"value":1059},"    bundle_sid=bundle_sid\n",{"type":42,"tag":277,"props":1061,"children":1062},{"class":279,"line":334},[1063],{"type":42,"tag":277,"props":1064,"children":1065},{},[1066],{"type":48,"value":776},{"type":42,"tag":86,"props":1068,"children":1069},{},[],{"type":42,"tag":43,"props":1071,"children":1073},{"id":1072},"updating-an-approved-bundle",[1074],{"type":48,"value":1075},"Updating an Approved Bundle",{"type":42,"tag":51,"props":1077,"children":1078},{},[1079],{"type":48,"value":1080},"When regulations change, you'll receive an email. Update without deprovisioning numbers:",{"type":42,"tag":1082,"props":1083,"children":1084},"ol",{},[1085,1096,1106,1116],{"type":42,"tag":1086,"props":1087,"children":1088},"li",{},[1089,1094],{"type":42,"tag":57,"props":1090,"children":1091},{},[1092],{"type":48,"value":1093},"Copy",{"type":48,"value":1095}," the approved bundle into a mutable state via the Bundle Copies resource",{"type":42,"tag":1086,"props":1097,"children":1098},{},[1099,1104],{"type":42,"tag":57,"props":1100,"children":1101},{},[1102],{"type":48,"value":1103},"Update",{"type":48,"value":1105}," the End-User or Supporting Document on the copy",{"type":42,"tag":1086,"props":1107,"children":1108},{},[1109,1114],{"type":42,"tag":57,"props":1110,"children":1111},{},[1112],{"type":48,"value":1113},"Re-evaluate",{"type":48,"value":1115}," the copy",{"type":42,"tag":1086,"props":1117,"children":1118},{},[1119,1124],{"type":42,"tag":57,"props":1120,"children":1121},{},[1122],{"type":48,"value":1123},"Replace",{"type":48,"value":1125}," items in the original bundle via the Replace Items resource",{"type":42,"tag":51,"props":1127,"children":1128},{},[1129],{"type":48,"value":1130},"Phone numbers remain provisioned throughout this process.",{"type":42,"tag":51,"props":1132,"children":1133},{},[1134,1139],{"type":42,"tag":57,"props":1135,"children":1136},{},[1137],{"type":48,"value":1138},"Alternative:",{"type":48,"value":1140}," Create a new bundle → get it approved → remap numbers to the new bundle.",{"type":42,"tag":51,"props":1142,"children":1143},{},[1144,1149,1151,1158,1160],{"type":42,"tag":57,"props":1145,"children":1146},{},[1147],{"type":48,"value":1148},"Docs:",{"type":48,"value":1150}," ",{"type":42,"tag":75,"props":1152,"children":1155},{"href":1153,"rel":1154},"https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-copies",[79],[1156],{"type":48,"value":1157},"Bundle Copies",{"type":48,"value":1159}," | ",{"type":42,"tag":75,"props":1161,"children":1164},{"href":1162,"rel":1163},"https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-replace-items",[79],[1165],{"type":48,"value":1166},"Replace Items",{"type":42,"tag":86,"props":1168,"children":1169},{},[],{"type":42,"tag":43,"props":1171,"children":1173},{"id":1172},"isv-multi-account-pattern",[1174],{"type":48,"value":1175},"ISV \u002F Multi-Account Pattern",{"type":42,"tag":51,"props":1177,"children":1178},{},[1179],{"type":48,"value":1180},"If managing Twilio subaccounts for multiple customers:",{"type":42,"tag":1182,"props":1183,"children":1184},"ul",{},[1185,1195,1207],{"type":42,"tag":1086,"props":1186,"children":1187},{},[1188,1193],{"type":42,"tag":57,"props":1189,"children":1190},{},[1191],{"type":48,"value":1192},"Each customer needs their own bundle",{"type":48,"value":1194}," — Do not reuse your business information in customer bundles",{"type":42,"tag":1086,"props":1196,"children":1197},{},[1198,1200,1205],{"type":48,"value":1199},"Use the ",{"type":42,"tag":57,"props":1201,"children":1202},{},[1203],{"type":48,"value":1204},"Bundle Clones",{"type":48,"value":1206}," resource to duplicate bundle structures across subaccounts",{"type":42,"tag":1086,"props":1208,"children":1209},{},[1210],{"type":48,"value":1211},"End-User records must reflect the actual end-user (your customer), not you",{"type":42,"tag":51,"props":1213,"children":1214},{},[1215,1219,1220],{"type":42,"tag":57,"props":1216,"children":1217},{},[1218],{"type":48,"value":1148},{"type":48,"value":1150},{"type":42,"tag":75,"props":1221,"children":1224},{"href":1222,"rel":1223},"https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi\u002Fbundles-clones",[79],[1225],{"type":48,"value":1204},{"type":42,"tag":86,"props":1227,"children":1228},{},[],{"type":42,"tag":43,"props":1230,"children":1232},{"id":1231},"cannot",[1233],{"type":48,"value":1234},"CANNOT",{"type":42,"tag":1182,"props":1236,"children":1237},{},[1238,1248,1258,1268,1278,1288,1298],{"type":42,"tag":1086,"props":1239,"children":1240},{},[1241,1246],{"type":42,"tag":57,"props":1242,"children":1243},{},[1244],{"type":48,"value":1245},"Cannot provision numbers without required bundles",{"type":48,"value":1247}," — Provisioning fails immediately. Check Regulations resource first.",{"type":42,"tag":1086,"props":1249,"children":1250},{},[1251,1256],{"type":42,"tag":57,"props":1252,"children":1253},{},[1254],{"type":48,"value":1255},"Cannot reuse one bundle across different number types",{"type":48,"value":1257}," — Each bundle is tied to a specific regulation (country + number type + end-user type).",{"type":42,"tag":1086,"props":1259,"children":1260},{},[1261,1266],{"type":42,"tag":57,"props":1262,"children":1263},{},[1264],{"type":48,"value":1265},"Locality-matching addresses required in ~33 countries",{"type":48,"value":1267}," — Germany (and others) require the End-User address to be within the region of the phone number prefix, not just any address in the country. US HQ address will fail for a Berlin number.",{"type":42,"tag":1086,"props":1269,"children":1270},{},[1271,1276],{"type":42,"tag":57,"props":1272,"children":1273},{},[1274],{"type":48,"value":1275},"Cannot hardcode regulation requirements",{"type":48,"value":1277}," — Regulations change periodically. Always query the Regulations resource dynamically.",{"type":42,"tag":1086,"props":1279,"children":1280},{},[1281,1286],{"type":42,"tag":57,"props":1282,"children":1283},{},[1284],{"type":48,"value":1285},"Do not create a new bundle when evaluation fails",{"type":48,"value":1287}," — Fix the existing bundle. Creating new ones wastes time and clutters your account.",{"type":42,"tag":1086,"props":1289,"children":1290},{},[1291,1296],{"type":42,"tag":57,"props":1292,"children":1293},{},[1294],{"type":48,"value":1295},"Cannot reuse your ISV info in customer bundles",{"type":48,"value":1297}," — Bundles must represent the actual end-user. Twilio audits this.",{"type":42,"tag":1086,"props":1299,"children":1300},{},[1301,1306,1308,1314],{"type":42,"tag":57,"props":1302,"children":1303},{},[1304],{"type":48,"value":1305},"Some markets are business-only",{"type":48,"value":1307}," — Individual provisioning not allowed. Check the ",{"type":42,"tag":172,"props":1309,"children":1311},{"className":1310},[],[1312],{"type":48,"value":1313},"EndUserType",{"type":48,"value":1315}," in the Regulation.",{"type":42,"tag":86,"props":1317,"children":1318},{},[],{"type":42,"tag":43,"props":1320,"children":1322},{"id":1321},"next-steps",[1323],{"type":48,"value":1324},"Next Steps",{"type":42,"tag":1182,"props":1326,"children":1327},{},[1328,1343,1358,1373],{"type":42,"tag":1086,"props":1329,"children":1330},{},[1331,1336,1337],{"type":42,"tag":57,"props":1332,"children":1333},{},[1334],{"type":48,"value":1335},"Choose number type before provisioning:",{"type":48,"value":1150},{"type":42,"tag":172,"props":1338,"children":1340},{"className":1339},[],[1341],{"type":48,"value":1342},"twilio-numbers-senders",{"type":42,"tag":1086,"props":1344,"children":1345},{},[1346,1351,1352],{"type":42,"tag":57,"props":1347,"children":1348},{},[1349],{"type":48,"value":1350},"Register numbers after provisioning:",{"type":48,"value":1150},{"type":42,"tag":172,"props":1353,"children":1355},{"className":1354},[],[1356],{"type":48,"value":1357},"twilio-compliance-onboarding",{"type":42,"tag":1086,"props":1359,"children":1360},{},[1361,1366,1367],{"type":42,"tag":57,"props":1362,"children":1363},{},[1364],{"type":48,"value":1365},"Country-specific requirements:",{"type":48,"value":1150},{"type":42,"tag":75,"props":1368,"children":1370},{"href":77,"rel":1369},[79],[1371],{"type":48,"value":1372},"Regulatory Guidelines",{"type":42,"tag":1086,"props":1374,"children":1375},{},[1376,1381,1382],{"type":42,"tag":57,"props":1377,"children":1378},{},[1379],{"type":48,"value":1380},"API reference:",{"type":48,"value":1150},{"type":42,"tag":75,"props":1383,"children":1386},{"href":1384,"rel":1385},"https:\u002F\u002Fwww.twilio.com\u002Fdocs\u002Fphone-numbers\u002Fregulatory\u002Fapi",[79],[1387],{"type":48,"value":1388},"Regulatory Compliance API",{"type":42,"tag":1390,"props":1391,"children":1392},"style",{},[1393],{"type":48,"value":1394},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1396,"total":1599},[1397,1416,1439,1456,1472,1491,1510,1526,1542,1556,1568,1583],{"slug":1398,"name":1398,"fn":1399,"description":1400,"org":1401,"tags":1402,"stars":1413,"repoUrl":1414,"updatedAt":1415},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1403,1406,1409,1412],{"name":1404,"slug":1405,"type":15},"Documents","documents",{"name":1407,"slug":1408,"type":15},"Healthcare","healthcare",{"name":1410,"slug":1411,"type":15},"Insurance","insurance",{"name":20,"slug":21,"type":15},28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":1417,"name":1417,"fn":1418,"description":1419,"org":1420,"tags":1421,"stars":1436,"repoUrl":1437,"updatedAt":1438},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1422,1425,1427,1430,1433],{"name":1423,"slug":1424,"type":15},".NET","dotnet",{"name":1426,"slug":1417,"type":15},"ASP.NET Core",{"name":1428,"slug":1429,"type":15},"Blazor","blazor",{"name":1431,"slug":1432,"type":15},"C#","csharp",{"name":1434,"slug":1435,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":1440,"name":1440,"fn":1441,"description":1442,"org":1443,"tags":1444,"stars":1436,"repoUrl":1437,"updatedAt":1455},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1445,1448,1451,1454],{"name":1446,"slug":1447,"type":15},"Apps SDK","apps-sdk",{"name":1449,"slug":1450,"type":15},"ChatGPT","chatgpt",{"name":1452,"slug":1453,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":1457,"name":1457,"fn":1458,"description":1459,"org":1460,"tags":1461,"stars":1436,"repoUrl":1437,"updatedAt":1471},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1462,1465,1468],{"name":1463,"slug":1464,"type":15},"API Development","api-development",{"name":1466,"slug":1467,"type":15},"CLI","cli",{"name":1469,"slug":1470,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":1473,"name":1473,"fn":1474,"description":1475,"org":1476,"tags":1477,"stars":1436,"repoUrl":1437,"updatedAt":1490},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1478,1481,1484,1487],{"name":1479,"slug":1480,"type":15},"Cloudflare","cloudflare",{"name":1482,"slug":1483,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":1485,"slug":1486,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":1488,"slug":1489,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":1492,"name":1492,"fn":1493,"description":1494,"org":1495,"tags":1496,"stars":1436,"repoUrl":1437,"updatedAt":1509},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1497,1500,1503,1506],{"name":1498,"slug":1499,"type":15},"Productivity","productivity",{"name":1501,"slug":1502,"type":15},"Project Management","project-management",{"name":1504,"slug":1505,"type":15},"Strategy","strategy",{"name":1507,"slug":1508,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":1511,"name":1511,"fn":1512,"description":1513,"org":1514,"tags":1515,"stars":1436,"repoUrl":1437,"updatedAt":1525},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1516,1519,1521,1524],{"name":1517,"slug":1518,"type":15},"Design","design",{"name":1520,"slug":1511,"type":15},"Figma",{"name":1522,"slug":1523,"type":15},"Frontend","frontend",{"name":1452,"slug":1453,"type":15},"2026-04-12T05:06:47.939943",{"slug":1527,"name":1527,"fn":1528,"description":1529,"org":1530,"tags":1531,"stars":1436,"repoUrl":1437,"updatedAt":1541},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1532,1533,1536,1537,1538],{"name":1517,"slug":1518,"type":15},{"name":1534,"slug":1535,"type":15},"Design System","design-system",{"name":1520,"slug":1511,"type":15},{"name":1522,"slug":1523,"type":15},{"name":1539,"slug":1540,"type":15},"UI Components","ui-components","2026-05-10T05:59:52.971881",{"slug":1543,"name":1543,"fn":1544,"description":1545,"org":1546,"tags":1547,"stars":1436,"repoUrl":1437,"updatedAt":1555},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1548,1549,1550,1553,1554],{"name":1517,"slug":1518,"type":15},{"name":1534,"slug":1535,"type":15},{"name":1551,"slug":1552,"type":15},"Documentation","documentation",{"name":1520,"slug":1511,"type":15},{"name":1522,"slug":1523,"type":15},"2026-05-16T06:07:47.821474",{"slug":1557,"name":1557,"fn":1558,"description":1559,"org":1560,"tags":1561,"stars":1436,"repoUrl":1437,"updatedAt":1567},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1562,1563,1564,1565,1566],{"name":1517,"slug":1518,"type":15},{"name":1520,"slug":1511,"type":15},{"name":1522,"slug":1523,"type":15},{"name":1539,"slug":1540,"type":15},{"name":1434,"slug":1435,"type":15},"2026-05-16T06:07:40.583615",{"slug":1569,"name":1569,"fn":1570,"description":1571,"org":1572,"tags":1573,"stars":1436,"repoUrl":1437,"updatedAt":1582},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1574,1577,1578,1581],{"name":1575,"slug":1576,"type":15},"Animation","animation",{"name":1469,"slug":1470,"type":15},{"name":1579,"slug":1580,"type":15},"Creative","creative",{"name":1517,"slug":1518,"type":15},"2026-05-02T05:31:48.48485",{"slug":1584,"name":1584,"fn":1585,"description":1586,"org":1587,"tags":1588,"stars":1436,"repoUrl":1437,"updatedAt":1598},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1589,1590,1591,1594,1597],{"name":1579,"slug":1580,"type":15},{"name":1517,"slug":1518,"type":15},{"name":1592,"slug":1593,"type":15},"Image Generation","image-generation",{"name":1595,"slug":1596,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675,{"items":1601,"total":1714},[1602,1618,1634,1646,1664,1682,1702],{"slug":1603,"name":1603,"fn":1604,"description":1605,"org":1606,"tags":1607,"stars":25,"repoUrl":26,"updatedAt":27},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1608,1611,1614,1617],{"name":1609,"slug":1610,"type":15},"Accessibility","accessibility",{"name":1612,"slug":1613,"type":15},"Charts","charts",{"name":1615,"slug":1616,"type":15},"Data Visualization","data-visualization",{"name":1517,"slug":1518,"type":15},{"slug":1619,"name":1619,"fn":1620,"description":1621,"org":1622,"tags":1623,"stars":25,"repoUrl":26,"updatedAt":1633},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1624,1627,1630],{"name":1625,"slug":1626,"type":15},"Agents","agents",{"name":1628,"slug":1629,"type":15},"Browser Automation","browser-automation",{"name":1631,"slug":1632,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":1635,"name":1635,"fn":1636,"description":1637,"org":1638,"tags":1639,"stars":25,"repoUrl":26,"updatedAt":1645},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1640,1641,1644],{"name":1628,"slug":1629,"type":15},{"name":1642,"slug":1643,"type":15},"Local Development","local-development",{"name":1631,"slug":1632,"type":15},"2026-04-06T18:41:17.526867",{"slug":1647,"name":1647,"fn":1648,"description":1649,"org":1650,"tags":1651,"stars":25,"repoUrl":26,"updatedAt":1663},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1652,1653,1654,1657,1660],{"name":1625,"slug":1626,"type":15},{"name":1485,"slug":1486,"type":15},{"name":1655,"slug":1656,"type":15},"SDK","sdk",{"name":1658,"slug":1659,"type":15},"Serverless","serverless",{"name":1661,"slug":1662,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":1665,"name":1665,"fn":1666,"description":1667,"org":1668,"tags":1669,"stars":25,"repoUrl":26,"updatedAt":1681},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1670,1671,1674,1677,1678],{"name":1522,"slug":1523,"type":15},{"name":1672,"slug":1673,"type":15},"React","react",{"name":1675,"slug":1676,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":1539,"slug":1540,"type":15},{"name":1679,"slug":1680,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":1683,"name":1683,"fn":1684,"description":1685,"org":1686,"tags":1687,"stars":25,"repoUrl":26,"updatedAt":1701},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1688,1691,1694,1697,1700],{"name":1689,"slug":1690,"type":15},"AI Infrastructure","ai-infrastructure",{"name":1692,"slug":1693,"type":15},"Cost Optimization","cost-optimization",{"name":1695,"slug":1696,"type":15},"LLM","llm",{"name":1698,"slug":1699,"type":15},"Performance","performance",{"name":1679,"slug":1680,"type":15},"2026-04-06T18:40:44.377464",{"slug":1703,"name":1703,"fn":1704,"description":1705,"org":1706,"tags":1707,"stars":25,"repoUrl":26,"updatedAt":1713},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1708,1709,1712],{"name":1692,"slug":1693,"type":15},{"name":1710,"slug":1711,"type":15},"Database","database",{"name":1695,"slug":1696,"type":15},"2026-04-06T18:41:08.513425",600]