diff --git a/readme.md b/readme.md
index f73b1dde38..35af8f9412 100644
--- a/readme.md
+++ b/readme.md
@@ -931,6 +931,35 @@ echo $faker->dni; // '77446565E'
 echo $faker->vat;           // "A35864370"
 ```
 
+### `Faker\Provider\fa_IR\Address`
+
+```php
+<?php
+
+// Generates a random address
+echo $faker->address; // "استان زنجان خیابان بهار ساختمان آفتاب پلاک 24"
+
+// Generates a random building name
+echo $faker->building; // "ساختمان آفتاب"
+
+// Returns a random city name
+echo $faker->city // "استان زنجان"
+
+//
+```
+
+### `Faker\Provider\fa_IR\Company`
+
+```php
+<?php
+
+// Generates a random company name
+echo $faker->company; // "شرکت نساجی امیدی"
+
+// Generates a random contract type
+echo $faker->contract; // "رسمی"
+```
+
 ### `Faker\Provider\fi_FI\Payment`
 
 ```php