action telnyx_get_usage_reports {
  label: "getUsageReports"
  description: "Fetch all messaging usage reports. Usage reports are aggregated messaging data for specified time period and breakdown"
  provider: telnyx
  method: GET
  path: "/reports/mdr_usage_reports"
  encoding: json
  input: {
    type: "object"
    properties: {
      "page[number]": {
        type: "integer"
        format: "int32"
      }
      "page[size]": {
        type: "integer"
        format: "int32"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      data: {
        type: "array"
        items: {
          type: "object"
          properties: {
            aggregation_type: {
              type: "string"
              enum: ["NO_AGGREGATION", "PROFILE", "TAGS"]
            }
            connections: {
              type: "array"
              items: {
                type: "integer"
                format: "int64"
              }
            }
            created_at: {
              type: "string"
              format: "date-time"
            }
            end_date: {
              type: "string"
              format: "date-time"
            }
            id: {
              type: "string"
              format: "uuid"
              description: "Identifies the resource"
            }
            profiles: {
              type: "string"
            }
            record_type: {
              type: "string"
            }
            report_url: {
              type: "string"
            }
            result: {
              type: "array"
              items: {
                type: "object"
                properties: {
                  carrier_passthrough_fee: {
                    type: "string"
                  }
                  connection: {
                    type: "string"
                  }
                  cost: {
                    type: "string"
                  }
                  currency: {
                    type: "string"
                  }
                  delivered: {
                    type: "string"
                  }
                  direction: {
                    type: "string"
                  }
                  message_type: {
                    type: "string"
                  }
                  parts: {
                    type: "string"
                  }
                  product: {
                    type: "string"
                  }
                  profile_id: {
                    type: "string"
                  }
                  received: {
                    type: "string"
                  }
                  sent: {
                    type: "string"
                  }
                  tags: {
                    type: "string"
                  }
                  tn_type: {
                    type: "string"
                  }
                }
              }
            }
            start_date: {
              type: "string"
              format: "date-time"
            }
            status: {
              type: "string"
              enum: ["PENDING", "COMPLETE", "FAILED", "EXPIRED"]
            }
            updated_at: {
              type: "string"
              format: "date-time"
            }
          }
        }
      }
      meta: {
        type: "object"
        properties: {
          page_number: {
            type: "integer"
          }
          page_size: {
            type: "integer"
          }
          total_pages: {
            type: "integer"
          }
          total_results: {
            type: "integer"
          }
        }
      }
    }
  }
}