From 9a4361cad7fc73960f9974b3f94f9dfe016bea06 Mon Sep 17 00:00:00 2001
From: Artur Beljajev <artur.beljajev@internet.ee>
Date: Sun, 28 Jan 2018 17:04:26 +0200
Subject: [PATCH] Update REST API documentation [ci skip]

#660
---
 doc/repp-doc.md                 |  1 +
 doc/repp/v1/domain_transfers.md | 48 +++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 doc/repp/v1/domain_transfers.md

diff --git a/doc/repp-doc.md b/doc/repp-doc.md
index 8eab257ab..4a79f093f 100644
--- a/doc/repp-doc.md
+++ b/doc/repp-doc.md
@@ -17,4 +17,5 @@ Main communication specification through Restful EPP (REPP):
 
 [Contact related functions](repp/v1/contact.md)  
 [Domain related functions](repp/v1/domain.md)  
+[Domain transfers](repp/v1/domain_transfers.md)  
 [Account related functions](repp/v1/account.md)
diff --git a/doc/repp/v1/domain_transfers.md b/doc/repp/v1/domain_transfers.md
new file mode 100644
index 000000000..228033a7c
--- /dev/null
+++ b/doc/repp/v1/domain_transfers.md
@@ -0,0 +1,48 @@
+# Domain transfers
+
+## POST /repp/v1/domain_transfers
+Transfers domains.
+
+#### Request
+```
+GET /repp/v1/domain_transfers
+Accept: application/json
+Content-Type: application/json
+Authorization: Basic dGVzdDp0ZXN0dGVzdA==
+
+{
+   "data":{
+      "domainTransfers":[
+         {
+            "domainName":"example.com",
+            "transferCode":"63e7"
+         },
+         {
+            "domainName":"example.org",
+            "transferCode":"15f9"
+         }
+      ]
+   }
+}
+```
+
+#### Response on success
+```
+HTTP/1.1 204
+```
+
+#### Response on failure
+```
+HTTP/1.1 400
+Content-Type: application/json
+{
+   "errors":[
+      {
+         "title":"example.com transfer code is wrong"
+      },
+      {
+         "title":"example.org does not exist"
+      }
+   ]
+}
+```