action twilio_fetch_incoming_phone_number {
  label: "FetchIncomingPhoneNumber"
  description: "Fetch an incoming-phone-number belonging to the account used to make the request."
  provider: twilio
  method: GET
  path: "/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}.json"
  encoding: json
  input: {
    type: "object"
    properties: {
      AccountSid: {
        type: "string"
      }
      Sid: {
        type: "string"
      }
    }
    required: ["AccountSid", "Sid"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      account_sid: {
        type: "string"
        description: "The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this IncomingPhoneNumber resource."
      }
      address_requirements: {
        type: "string"
        enum: ["none", "any", "local", "foreign"]
      }
      address_sid: {
        type: "string"
        description: "The SID of the Address resource associated with the phone number."
      }
      api_version: {
        type: "string"
        description: "The API version used to start a new TwiML session."
      }
      beta: {
        type: "boolean"
        description: "Whether the phone number is new to the Twilio platform. Can be: `true` or `false`."
      }
      bundle_sid: {
        type: "string"
        description: "The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations."
      }
      capabilities: {
        type: "object"
        format: "phone-number-capabilities"
        description: "The set of Boolean properties that indicate whether a phone number can receive calls or messages.  Capabilities are  `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`."
        properties: {
          fax: {
            type: "boolean"
          }
          mms: {
            type: "boolean"
          }
          sms: {
            type: "boolean"
          }
          voice: {
            type: "boolean"
          }
        }
      }
      date_created: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
      }
      date_updated: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."
      }
      emergency_address_sid: {
        type: "string"
        description: "The SID of the emergency address configuration that we use for emergency calling from this phone number."
      }
      emergency_address_status: {
        type: "string"
        enum: ["registered", "unregistered", "pending-registration", "registration-failure", "pending-unregistration", "unregistration-failure"]
      }
      emergency_status: {
        type: "string"
        enum: ["Active", "Inactive"]
      }
      friendly_name: {
        type: "string"
        description: "The string that you assigned to describe the resource."
      }
      identity_sid: {
        type: "string"
        description: "The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations."
      }
      origin: {
        type: "string"
        description: "The phone number's origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers."
      }
      phone_number: {
        type: "string"
        format: "phone-number"
        description: "The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number."
      }
      sid: {
        type: "string"
        description: "The unique string that that we created to identify this IncomingPhoneNumber resource."
      }
      sms_application_sid: {
        type: "string"
        description: "The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application."
      }
      sms_fallback_method: {
        type: "string"
        format: "http-method"
        description: "The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`."
        enum: ["HEAD", "GET", "POST", "PATCH", "PUT", "DELETE"]
      }
      sms_fallback_url: {
        type: "string"
        format: "uri"
        description: "The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`."
      }
      sms_method: {
        type: "string"
        format: "http-method"
        description: "The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`."
        enum: ["HEAD", "GET", "POST", "PATCH", "PUT", "DELETE"]
      }
      sms_url: {
        type: "string"
        format: "uri"
        description: "The URL we call when the phone number receives an incoming SMS message."
      }
      status: {
        type: "string"
      }
      status_callback: {
        type: "string"
        format: "uri"
        description: "The URL we call using the `status_callback_method` to send status information to your application."
      }
      status_callback_method: {
        type: "string"
        format: "http-method"
        description: "The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`."
        enum: ["HEAD", "GET", "POST", "PATCH", "PUT", "DELETE"]
      }
      trunk_sid: {
        type: "string"
        description: "The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa."
      }
      uri: {
        type: "string"
        description: "The URI of the resource, relative to `https://api.twilio.com`."
      }
      voice_application_sid: {
        type: "string"
        description: "The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa."
      }
      voice_caller_id_lookup: {
        type: "boolean"
        description: "Whether we look up the caller's caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`."
      }
      voice_fallback_method: {
        type: "string"
        format: "http-method"
        description: "The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`."
        enum: ["HEAD", "GET", "POST", "PATCH", "PUT", "DELETE"]
      }
      voice_fallback_url: {
        type: "string"
        format: "uri"
        description: "The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`."
      }
      voice_method: {
        type: "string"
        format: "http-method"
        description: "The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`."
        enum: ["HEAD", "GET", "POST", "PATCH", "PUT", "DELETE"]
      }
      voice_receive_mode: {
        type: "string"
        enum: ["voice", "fax"]
      }
      voice_url: {
        type: "string"
        format: "uri"
        description: "The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set."
      }
    }
  }
}