Retrieve a list of all Bundles for an account

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://twilio.demo.bump-doc.com/doc/numbers/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"Numbers MCP server": {
  "url": "https://twilio.demo.bump-doc.com/doc/numbers/mcp"
}
Close
GET /v2/RegulatoryCompliance/Bundles

TODO: Resource-level docs

Retrieve a list of all Bundles for an account.

Query parameters

  • Status string

    The verification status of the Bundle resource. Please refer to Bundle Statuses for more details.

    Values are draft, pending-review, in-review, twilio-rejected, twilio-approved, or provisionally-approved.

  • FriendlyName string

    The string that you assigned to describe the resource. The column can contain 255 variable characters.

  • RegulationSid string

    The unique string of a Regulation resource that is associated to the Bundle resource.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RN[0-9a-fA-F]{32}$.

  • IsoCountry string

    The 2-digit ISO country code of the Bundle's phone number country ownership request.

  • NumberType string

    The type of phone number of the Bundle's ownership request. Can be local, mobile, national, or tollfree.

  • HasValidUntilDate boolean

    Indicates that the Bundle is a valid Bundle until a specified expiration date.

  • SortBy string

    Can be valid-until or date-updated. Defaults to date-created.

    Values are valid-until or date-updated.

  • SortDirection string

    Default is DESC. Can be ASC or DESC.

    Values are ASC or DESC.

  • ValidUntilDate string(date-time)

    Date to filter Bundles having their valid_until_date before or after the specified date. Can be ValidUntilDate>= or ValidUntilDate<=. Both can be used in conjunction as well. ISO 8601 is the acceptable date format.

  • ValidUntilDate< string(date-time)

    Date to filter Bundles having their valid_until_date before or after the specified date. Can be ValidUntilDate>= or ValidUntilDate<=. Both can be used in conjunction as well. ISO 8601 is the acceptable date format.

  • ValidUntilDate> string(date-time)

    Date to filter Bundles having their valid_until_date before or after the specified date. Can be ValidUntilDate>= or ValidUntilDate<=. Both can be used in conjunction as well. ISO 8601 is the acceptable date format.

  • PageSize integer

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • meta object
      Hide meta attributes Show meta attributes object
      • first_page_url string(uri)
      • key string
      • next_page_url string(uri)
      • page integer
      • page_size integer
      • previous_page_url string(uri)
      • url string(uri)
    • results array[object]
      Hide results attributes Show results attributes object
      • account_sid string | null

        The SID of the Account that created the resource

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

      • date_created string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was created

      • date_updated string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was last updated

      • email string | null

        The email address

      • friendly_name string | null

        The string that you assigned to describe the resource

      • regulation_sid string | null

        The unique string of a regulation.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RN[0-9a-fA-F]{32}$.

      • sid string | null

        The unique string that identifies the resource.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BU[0-9a-fA-F]{32}$.

      • status string | null

        The verification status of the Bundle resource

        Values are draft, pending-review, in-review, twilio-rejected, twilio-approved, or provisionally-approved.

      • status_callback string(uri) | null

        The URL we call to inform your application of status changes.

      • url string(uri) | null

        The absolute URL of the Bundle resource

      • valid_until string(date-time) | null

        The ISO 8601 date and time in GMT when the resource will be valid until.

GET /v2/RegulatoryCompliance/Bundles
curl \
 --request GET 'https://numbers.twilio.com/v2/RegulatoryCompliance/Bundles' \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "first_page_url": "https://example.com",
    "key": "string",
    "next_page_url": "https://example.com",
    "page": 42,
    "page_size": 42,
    "previous_page_url": "https://example.com",
    "url": "https://example.com"
  },
  "results": [
    {
      "account_sid": "string",
      "date_created": "2026-05-04T09:42:00Z",
      "date_updated": "2026-05-04T09:42:00Z",
      "email": "string",
      "friendly_name": "string",
      "links": {},
      "regulation_sid": "string",
      "sid": "string",
      "status": "draft",
      "status_callback": "https://example.com",
      "url": "https://example.com",
      "valid_until": "2026-05-04T09:42:00Z"
    }
  ]
}