action twilio_fetch_message {
  label: "FetchMessage"
  description: "Fetch a message belonging to the account used to make the request"
  provider: twilio
  method: GET
  path: "/2010-04-01/Accounts/{AccountSid}/Messages/{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 sent the message that created the resource."
      }
      api_version: {
        type: "string"
        description: "The API version used to process the message."
      }
      body: {
        type: "string"
        description: "The message text. Can be up to 1,600 characters long."
      }
      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_sent: {
        type: "string"
        format: "date-time-rfc-2822"
        description: "The date and time in GMT that the resource was sent specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. For outgoing messages, this is when we sent the message. For incoming messages, this is when we made the HTTP request to your application. "
      }
      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."
      }
      direction: {
        type: "string"
        enum: ["inbound", "outbound-api", "outbound-call", "outbound-reply"]
      }
      error_code: {
        type: "integer"
        description: "The error code returned if your message `status` is `failed` or `undelivered`. The error_code provides more information about the failure. If the message was successful, this value is null."
      }
      error_message: {
        type: "string"
        description: "The description of the `error_code` if your message `status` is `failed` or `undelivered`. If the message was successful, this value is null."
      }
      from: {
        type: "string"
        format: "phone-number"
        description: "The phone number (in [E.164](https://en.wikipedia.org/wiki/E.164) format), [alphanumeric sender ID](https://www.twilio.com/docs/sms/send-messages#use-an-alphanumeric-sender-id), or [Wireless SIM](https://www.twilio.com/docs/wireless/tutorials/communications-guides/how-to-send-and-receive-text-messages) that initiated the message. For incoming messages, this will be the number of the sending phone. For outgoing messages, this value will be one of your Twilio phone numbers or the alphanumeric sender ID used."
      }
      messaging_service_sid: {
        type: "string"
        description: "The SID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) used with the message. The value is null if a Messaging Service was not used."
      }
      num_media: {
        type: "string"
        description: "The number of media files associated with the message. A message can send up to 10 media files."
      }
      num_segments: {
        type: "string"
        description: "The number of segments that make up the complete message. A message body that is too large to be sent in a single SMS message is segmented and charged as multiple messages. Inbound messages over 160 characters are reassembled when the message is received. Note: When using a Messaging Service to send messages, `num_segments` will always be 0 in Twilio's response to your API request."
      }
      price: {
        type: "string"
        description: "The amount billed for the message, in the currency specified by `price_unit`.  Note that your account is charged for each segment we send to the handset. Populated after the message has been sent. May not be immediately available."
      }
      price_unit: {
        type: "string"
        format: "currency"
        description: "The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`)."
      }
      sid: {
        type: "string"
        description: "The unique string that that we created to identify the Message resource."
      }
      status: {
        type: "string"
        enum: ["queued", "sending", "sent", "failed", "delivered", "undelivered", "receiving", "received", "accepted", "scheduled", "read", "partially_delivered", "canceled"]
      }
      subresource_uris: {
        type: "object"
        format: "uri-map"
        description: "A list of related resources identified by their URIs relative to `https://api.twilio.com`"
      }
      to: {
        type: "string"
        description: "The phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format that received the message. For incoming messages, this will be one of your Twilio phone numbers. For outgoing messages, this will be the sending phone."
      }
      uri: {
        type: "string"
        description: "The URI of the resource, relative to `https://api.twilio.com`."
      }
    }
  }
}