API explorerChangelog
API explorer
Changelog

Theme switcher

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

Base URL

Production:

https://globalr.com/api/v2

Language Box

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

Was this section helpful?

What made this section unhelpful for you?

Change domain contact information

Header Parameters

acceptstring
content-typestring
Authorizationstring

Body Parameters

namestring

Domain name

contactsobject

Update domain admin contact information

Show child attributes

_am-privatestring

Additional parameter

Response

200
Object

Response Attributes

statusnumber
textStatusstring
messagestring
errorsarray
422
Object

Response Attributes

statusnumber
textStatusstring
errorsobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

PUT

/domain

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 curl --location --request PUT 'https://globalr.com/api/v2/domain' \ --header 'accept: application/json' \ --header 'Authorization: Bearer ACCESS_TOKEN' \ --data-raw '{ "name": "example.am", "contacts": { "admin": { "name": "Jhone", "surname": "Smith", "organisation": "Company (Optional)", "email": "user@example.com", "phone": "+192512345789", "mobile_phone": "+195812345678 (Optional)", "fax": "+195812345678 (Optional)", "country": "US", "city": "New York", "state": "NY", "address": "My new street", "address2": "My second street (Optional)", "zip": "1001" } }, "_am-private": "1 (optional, only for am)" }'

Response

{
  "status": 200,
  "textStatus": "success",
  "message": "All changes made Successfully.",
  "errors": []
}
Was this section helpful?

What made this section unhelpful for you?

Change domain nameservers(DNS)

Header Parameters

acceptstring
content-typestring
Authorizationstring

Body Parameters

namestring
nsarray

Added new DNS list

Show child attributes

Response

200
Object

Response Attributes

statusnumber
textStatusstring
messagestring
errorsarray
422
Object

Response Attributes

statusnumber
textStatusstring
errorsobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

PUT

/domain

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 curl --location --request PUT 'https://globalr.com/api/v2/domain' \ --header 'accept: application/json' \ --header 'Authorization: Bearer ACCESS_TOKEN' \ --data '{ "name": "example.am", "ns": [ { "name": "ns3.globalr.com" }, { "name": "ns4.globalr.com" } ] }'

Response

{
  "status": 200,
  "textStatus": "success",
  "message": "All changes made Successfully.",
  "errors": []
}
Was this section helpful?

What made this section unhelpful for you?

Change domain additional field

More information about domain additional field follow the link

Header Parameters

acceptstring
content-typestring
Authorizationstring

Body Parameters

namestring
_am-privatestring

Response

200
Object

Response Attributes

statusnumber
textStatusstring
messagestring
errorsarray
422
Object

Response Attributes

statusnumber
textStatusstring
errorsobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

PUT

/domain

Select
1 2 3 4 5 6 7 curl --location --request PUT 'https://globalr.com/api/v2/domain' \ --header 'accept: application/json' \ --header 'Authorization: Bearer ACCESS_TOKEN' \ --data '{ "name": "example.am", "_am-private": "0 (optional, only for am)" }'

Response

{
  "status": 200,
  "textStatus": "success",
  "message": "All changes made Successfully.",
  "errors": []
}
Was this section helpful?

What made this section unhelpful for you?

NameServer bulk update

Header Parameters

acceptstring
content-typestring
Authorizationstring

Body Parameters

namesarray

All domains from the collection will be assigned the specified DNS

Show child attributes

nsarray

Show child attributes

Response

200
Object

Response Attributes

statusnumber
textStatusstring
messagestring
errorsarray
422
Object

Response Attributes

statusnumber
textStatusstring
errorsobject

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

PUT

/domain/nameservers/bulkupdate

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 curl --location --request PUT 'https://globalr.com/api/v2/domain/nameservers/bulkupdate' \ --header 'accept: application/json' \ --header 'Authorization: Bearer ACCESS_TOKEN' \ --data '{ "names": [ "test-for-globalr.am", "test1-for-globalr.am", "test2-for-globalr.am", "test3-for-globalr.am", "test4-for-globalr.am" ], "ns": [ { "name": "ns3.globalr.com" }, { "name": "ns4.globalr.com" } ] }'

Response

{
  "status": 200,
  "textStatus": "success",
  "message": "All changes made Successfully.",
  "errors": []
}
Was this section helpful?

What made this section unhelpful for you?

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

Response

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
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?