diff --git a/crates/api_common/src/community.rs b/crates/api_common/src/community.rs
index 2b03e1472..21161a756 100644
--- a/crates/api_common/src/community.rs
+++ b/crates/api_common/src/community.rs
@@ -98,6 +98,8 @@ pub struct BanFromCommunity {
   pub remove_data: Option<bool>,
   pub reason: Option<String>,
   /// A time that the ban will expire, in unix epoch seconds.
+  ///
+  /// A simple i64 unix timestamp is used for a simpler API client implementation.
   pub expires: Option<i64>,
 }
 
diff --git a/crates/api_common/src/person.rs b/crates/api_common/src/person.rs
index 1413d0c96..7730c8162 100644
--- a/crates/api_common/src/person.rs
+++ b/crates/api_common/src/person.rs
@@ -215,6 +215,8 @@ pub struct BanPerson {
   pub remove_data: Option<bool>,
   pub reason: Option<String>,
   /// A time that the ban will expire, in unix epoch seconds.
+  ///
+  /// A simple i64 unix timestamp is used for a simpler API client implementation.
   pub expires: Option<i64>,
 }