diff --git a/docs/gl_objects/issues.py b/docs/gl_objects/issues.py
index de4a3562d..44dd76749 100644
--- a/docs/gl_objects/issues.py
+++ b/docs/gl_objects/issues.py
@@ -28,6 +28,10 @@
 issue = project.issues.get(issue_id)
 # end project issues get
 
+# project issues get from iid
+issue = project.issues.list(iid=issue_iid)[0]
+# end project issues get from iid
+
 # project issues create
 issue = project.issues.create({'title': 'I have a bug',
                                'description': 'Something useful here.'})
diff --git a/docs/gl_objects/issues.rst b/docs/gl_objects/issues.rst
index b3b1cf1e8..2db2b60f0 100644
--- a/docs/gl_objects/issues.rst
+++ b/docs/gl_objects/issues.rst
@@ -104,6 +104,12 @@ Get a project issue:
    :start-after: # project issues get
    :end-before: # end project issues get
 
+Get a project issue from its `iid` (v3 only. Issues are retrieved by iid in V4 by default):
+
+.. literalinclude:: issues.py
+   :start-after: # project issues get from iid
+   :end-before: # end project issues get from iid
+
 Create a new issue:
 
 .. literalinclude:: issues.py