# API Introduction

The Domains API is organized around [REST](http://en.wikipedia.org/wiki/Representational_State_Transfer), has predictable resource-oriented URLs, returns [JSON-encoded](http://www.json.org/) responses, and uses standard HTTP response codes, authentication, and verbs.

### API Host

This is the production API host:

* `https://domains-api.com`

### Authentication

The API uses API keys to authenticate requests. You can view and manage your API keys in [your account page](https://dmns.app/account/api-keys).

It can be used in 2 ways when making requests:

* As a query parameter in url: `.../domain/example.com?key=sk_abc123`
* As the Authorization header: `Authorization: Bearer sk_abc123`

Check the examples for more details.

### Errors

Sometimes the request or the servers are not ok, and we'll let you know. Errors are always reflected in the returned status codes:

* `4xx`: There is a problem with your request. Detailed info will be included as plain text in the response
* `5xx`: The server had a problem processing the request. More details will be returned as plain text in the response

### Rate limits