---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/22217#article
headline: "22217: Missing Supporting Document field"
url: https://www.twilio.com/docs/api/errors/22217
inLanguage: en
dateModified: 2026-06-09T14:10:28.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 22217: Missing Supporting Document field

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when your Regulatory Bundle is missing a field required for one of its Supporting Documents. A Regulation defines the required End-User and Supporting Document values, and the Supporting Document Type resource returns the `fields` your document must include.

### Possible causes

* Your application created or updated a Supporting Document without all required `attributes` for the selected Supporting Document Type.
* You relied on hardcoded field requirements instead of retrieving the current Regulation. Regulations can change, and the Regulation resource is designed to provide the values required for regulatory compliance.
* The applicable Regulation requires one or more Supporting Document fields exposed through `fields` or `detailed_fields`, but your bundle omitted one of them.

### Possible solutions

* Fetch the applicable Regulation for the phone number country, number type, and end-user type. Set `includeConstraints=true` so you can review the required document fields before you create or update the bundle.
* Retrieve the selected Supporting Document Type and provide every field listed in its `fields` array when you create the Supporting Document.
* Update or recreate the Supporting Document with complete `attributes`, then add it to the Regulatory Bundle. If the Regulation requires document proof, upload a supported file type such as JPEG, PNG, or PDF up to 5 MB.

#### Additional resources

* [Regulation Resource](/docs/phone-numbers/regulatory/api/regulations)
* [Supporting Document Types Resource](/docs/phone-numbers/regulatory/api/supporting-document-types)
* [Supporting Documents Resource](/docs/phone-numbers/regulatory/api/supporting-documents)