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

Example implementation in Github

Was this section helpful?

What made this section unhelpful for you?

Base URL

Production:

https://globalr.com/api/v2

Language Box

Authentication

Select...
Authorization: Bearer YOUR_API_KEY

Was this section helpful?

What made this section unhelpful for you?

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.

Was this section helpful?

What made this section unhelpful for you?

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.

Was this section helpful?

What made this section unhelpful for you?

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.

Was this section helpful?

What made this section unhelpful for you?

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.

Was this section helpful?

What made this section unhelpful for you?

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.

Feel free to navigate through the sections and explore the available endpoints for your desired functionality.

Was this section helpful?

What made this section unhelpful for you?

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.

That's a general introduction to the Globalr API documentation. Remember to provide detailed information about each endpoint, including their parameters, request/response examples, and any additional considerations in the subsequent sections of the documentation.

Was this section helpful?

What made this section unhelpful for you?

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 block of contact information - Owner, Administrative, Technical and Billing. Each block could be updated seperately. While update of any information in some block, 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 send test request you mast send param mode=test

Transfer Domain

Transfer procedure divorced to two type.

  • transfer must be done in GlobalR system
  • transfer from other registrar

In any case more preferable make two request first check domain can be transferred or not (and which way it can be transferеd), second send transfer code.

If domain that must be transferеd registered thru globalr.com, in checking part our system will generate inner transfer code and will send to admin email.

Other ways you must send transfer code, that you get from losing registrar or registry.

Prices

This API call get extension prices list.

Header Parameters

Authorizationstring
Content-Typestring

Query Parameters

limitinteger

Limit of extension list

offsetinteger
searchstring

Search name

Responses

200
Object

Response Attributes

limitnumber
offsetnumber
countnumber
dataarray

Show child attributes

403
Object

Response Attributes

dataarray
Was this section helpful?

What made this section unhelpful for you?

GET

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

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

Response

{
  "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
    }
  ]
}