# Introduction

Welcome to the BETA Globalr API documentation. This API allows developers to interact with the Globalr system programmatically, providing a set of endpoints and functionalities to manage domains, user accounts, and more.

**To switch to the first version you can follow the link** [**https://globalr.com/doc/api**](/content/doc/api/index.html)

Example implementation in [Github](https://github.com/davitGlobalr/global_r_library)

# Base URL

Production:

https://globalr.com/api/v2

# Authentication

Plain Text

```
Authorization: Bearer YOUR_API_KEY
```

# Base URL

The base URL for all API endpoints is `https://api.globalr.com/api/v2/`. Make sure to prepend this base URL to each endpoint path mentioned in the documentation.

# Response Format

The API supports JSON as the primary response format. All responses will have a consistent structure with relevant data and, where applicable, error information.

# Rate Limiting

To ensure fair usage and maintain system stability, the Globalr API implements rate limiting. Each API key is subject to a certain number of requests per minute. Per minute you can send `128 request`. If you exceed the rate limit, you will receive a `429 Too Many Requests` response. Please refer to the response headers for information on the rate limit and the number of requests remaining.

# Error Handling

The API follows standard HTTP status codes to indicate the success or failure of a request. Errors are returned with an appropriate status code and an error response body providing more information about the encountered issue.

# API Reference

The API documentation is organized into different sections, each covering a specific aspect of the Globalr API. Below are the main sections of the API reference:

1. **Domains**: Learn how to register, manage, and query domain information using the Globalr API.

2. **Accounts**: Explore endpoints related to user accounts, including authentication, profile management, and billing details.

3. **Purchasing**: Discover endpoints for purchasing new domains, managing renewals, and handling payment-related operations.

# Feedback and Support

If you have any questions, feedback, or need assistance while using the Globalr API, please reach out to our support team at `support@globalr.com`. We're here to help you integrate and make the most of our API.

# User

This area you can explore endpoints related to user accounts, including authentication, profile management, and billing details.

# Domain

# Modify Domain records

There are four blocks of contact information - Owner, Administrative, Technical, and Billing. Each block could be updated separately. While updating any information in some block, the whole information of the block must be sent.

For .AM domain in the block of owner, you can’t change Name and Last Name or Company Name (in case of organization) information. This part requires printed documents.

If you want to send a test request, you must send param `mode=test`

# Transfer Domain

Transfer procedure divided into two types.

- Transfer must be done in GlobalR system

- Transfer from other registrar

In any case, it’s more preferable to make two requests: first, check if the domain can be transferred or not (and which way it can be transferred), and second send the transfer code.

If the domain that must be transferred is registered through globalr.com, in the checking part our system will generate an inner transfer code and will send it to the admin email. Otherwise, you must send the transfer code that you get from the losing registrar or registry.

# Prices

This API call gets extension prices list.

#### Header Parameters

- Authorization string
- Content-Type string

#### Query Parameters

- limit integer  
  Limit of extension list
- offset integer  
- search string
  Search name

### Response

200

Object

#### Response Attributes

- limit number
- offset number
- count number
- data array

### Example Request

GET

/prices?limit=20&offset=0&search=

cURL

`curl --location 'https://globalr.com/api/v2/prices?limit=20&offset=0' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Content-Type: application/json'`

### Example Response

200
403

```
{
  "limit": 20,
  "offset": 0,
  "count": null,
  "data": [
    {
      "id": 2,
      "name": ".ge",
      "price": 15.8,
      "renew_price": 15.8,
      "transfer_price": 15.8,
      "amount_with_trustee": null,
      "min_registration_year": 1
    }
  ]
}
```