# GNS

## Error Response

An error response is sent in the JSON format: `{"error":"*error_description*"}`

Following numbers are added for references inside the documentation only.

Error descriptions are:

    Nr. Error Description           - Explanation
    1)  Unknown Error               - Error is not specified
    2)  Record not found            - GNS record was not found, this is combined with the HTTP Error Code 404 Not Found

Error `1)` is always possible and is not listed in following requests.

### Requests

## GET Request

For this request `record_type` is optional. If missing or called with an invalid record_type, it will automatically be set to ANY.

Title | Return all records for given name
URL | `/gns/'lookup'?record_type='type'`
Method | GET
Data Params | none
Success Response | [{“value”: “value”, “record_type”: “type”, “expiration_time”: “time”, “flag”: flag},…]
Error Response | {“error”:”error_desc”} 2

## OPTIONS Request

Title | Get request options
URL | `/gns`
Method | OPTIONS
URL Params | none
Data Params | none
Success Response |
Error Response | none