From e2d2768b6e35de19ed96e45f61eb5f8c693888ee Mon Sep 17 00:00:00 2001
From: Maciej Szlosarczyk <maciej.szlosarczyk@eestiinternet.ee>
Date: Mon, 16 Jul 2018 14:26:59 +0300
Subject: [PATCH] Update domain endpoint

---
 doc/registrant-api/v1/domain.md | 68 +++++++++++++++++++++++++++++++--
 1 file changed, 64 insertions(+), 4 deletions(-)

diff --git a/doc/registrant-api/v1/domain.md b/doc/registrant-api/v1/domain.md
index db9b17978..bfc4349eb 100644
--- a/doc/registrant-api/v1/domain.md
+++ b/doc/registrant-api/v1/domain.md
@@ -17,7 +17,6 @@ Returns domains of the current registrant.
 GET repp/v1/registrant/domains?limit=1&details=true HTTP/1.1
 Accept: application/json
 Authorization: Bearer Z2l0bGFiOmdoeXQ5ZTRmdQ==
-Content-Length: 0
 Content-Type: application/json
 ```
 
@@ -81,15 +80,12 @@ Returns domain names with offset.
 GET repp/v1/registrant/domains?offset=1 HTTP/1.1
 Accept: application/json
 Authorization: Bearer Z2l0bGFiOmdoeXQ5ZTRmdQ==
-Content-Length: 0
 Content-Type: application/json
 ```
 
 #### Response
 ```
 HTTP/1.1 200
-Cache-Control: max-age=0, private, must-revalidate
-Content-Length: 54
 Content-Type: application/json
 
 {
@@ -99,3 +95,67 @@ Content-Type: application/json
   "total_number_of_records": 2
 }
 ```
+
+## GET repp/v1/registrant/domains/$UUID
+Returns domain names with offset.
+
+
+#### Request
+```
+GET repp/v1/registrant/domains/98d1083a-8863-4153-93e4-caee4a013535 HTTP/1.1
+Accept: application/json
+Authorization: Bearer Z2l0bGFiOmdoeXQ5ZTRmdQ==
+Content-Length: 0
+Content-Type: application/json
+```
+
+#### Response for success
+
+```
+HTTP/1.1 200
+Content-Type: application/json
+
+{
+  "uuid": "98d1083a-8863-4153-93e4-caee4a013535",
+  "name": "domain0.ee",
+  "registrar_id": 2,
+  "registered_at": "2015-09-09T09:11:14.861Z",
+  "status": null,
+  "valid_from": "2015-09-09T09:11:14.861Z",
+  "valid_to": "2016-09-09T09:11:14.861Z",
+  "registrant_id": 1,
+  "transfer_code": "98oiewslkfkd",
+  "created_at": "2015-09-09T09:11:14.861Z",
+  "updated_at": "2015-09-09T09:11:14.860Z",
+  "name_dirty": "domain0.ee",
+  "name_puny": "domain0.ee",
+  "period": 1,
+  "period_unit": "y",
+  "creator_str": null,
+  "updator_str": null,
+  "legacy_id": null,
+  "legacy_registrar_id": null,
+  "legacy_registrant_id": null,
+  "outzone_at": "2016-09-24T09:11:14.861Z",
+  "delete_at": "2016-10-24T09:11:14.861Z",
+  "registrant_verification_asked_at": null,
+  "registrant_verification_token": null,
+  "pending_json": {},
+  "force_delete_at": null,
+  "statuses": [
+    "ok"
+  ],
+  "reserved": false,
+  "status_notes": {},
+  "statuses_backup": []
+}
+```
+
+#### Response for failure
+
+```
+HTTP/1.1 404
+Content-Type: application/json
+
+{ "error": "Domain not found" }
+```