Globalr Documentation

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.

Production:

https://globalr.com/api/v2

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

Header Parameters

Content-Typestring

Body Parameters

emailstring Required

User account email

passwordstring Required

User account password

api_tokenstring

To get an API token, please contact the GlobalR support team.

Response

200

Object

Login response

Response Attributes

accessTokenstring

Api access token

refreshTokenstring

Api refresh token

curl --location 'https://globalr.com/api/v2/login' \
--header 'Content-Type: application/json' \
--data-raw '{
  "email": "email@example.com",
  "password": "******",
  "api_token": "yH3iQygyuPL9yvo24WSqwTtpWow5pv1JUWDjVUvJ"
}'

{
  "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMTQ5ODQ3YjBlNGJkNTQ1MDAxZGJlZTAwYTZjMWEwNjZmOWU5NTY3MWQ0YmMwZTk1ZmJmMDY5MWQzYTE3MWQ4MTZhZTIzYjY4NWUzY2I3MDIiLCJpYXQiOjE2NDMwOTk4MzQsIm5iZiI6MTY0MzA5OTgzNCwiZXhwIjoxNjc0NjM1ODM0LCJzdWIiOiI1YjA1ZTgxMC1jZGExLTRhMzYtYjE0Ni1mODA5OGM5NGJkMzYiLCJzY29wZXMiOltdfQ.LoNc40NN5S4EaNraNS8Qy9FeADehW5qOXfuZYDC5LGw1bCjfeI6z5VXUwGpRvef2ktLILMA3mvSgomDuhACOfqTZ-D8Cd2QGyeoa2b2qo_lDyGjxX6QNlMrrBkkevufdsv0OhN08YI8S6E4MZe5IIVJ2iHJy0KxIWeS5h9cnGU3lYohn1C27wmPxHMP5QTkzRT9iZi_ZCOVP6TOW_iTrkQWoa3bgiDgAB7gjGwiRrSvQbDcgJaBKoZqm0m-fO0PZt71ndoNMdk-JAxJFyJaT_yDfLOmWivZJTvSjCjJgswx35Z33C173jwhMveCGvqF_9W8w2pO1kKq3Q2G2fBR2ZpkaSol2w56BT2BHGWiGaIBl5RrcdikNuy0vfyrJt2qRf-L-9meUiOQv1zp6cFnoDDpF88Rp-Rq_sSruJYEVw5TapZMgg70Ea5YIv4GU6HGmBljmtRp8huSZJC0RHJVllQCEOjw4SznmjKuj2mQ-WjXT28Q9c2rV_zbURvDIYCG5Zdp4e9VHw6O1X8fiy_7j6Cv_cfyfZczk-hUvSA6nCsc-Vc2UXYQhl1YFWI8G1GDsduauU7or8byLOHLA25gPM1A2nYPwELeXNyx8LS_uWojMUxan-m8ARNkUg9yZgi5QI5gkD6mu9g_nHbv6pUqqrV6dDclUKX91gG7dxB6WNQ0",
  "refreshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMTQ5ODQ3YjBlNGJkNTQ1MDAxZGJlZTAwYTZjMWEwNjZmOWU5NTY3MWQ0YmMwZTk1ZmJmMDY5MWQzYTE3MWQ4MTZhZTIzYjY4NWUzY2I3MDIiLCJpYXQiOjE2NDMwOTk4MzQsIm5iZiI6MTY0MzA5OTgzNCwiZXhwIjoxNjc0NjM1ODM0LCJzdWIiOiI1YjA1ZTgxMC1jZGExLTRhMzYtYjE0Ni1mODA5OGM5NGJkMzYiLCJzY29wZXMiOltdfQ.LoNc40NN5S4EaNraNS8Qy9FeADehW5qOXfuZYDC5LGw1bCjfeI6z5VXUwGpRvef2ktLILMA3mvSgomDuhACOfqTZ-D8Cd2QGyeoa2b2qo_lDyGjxX6QNlMrrBkkevufdsv0OhN08YI8S6E4MZe5IIVJ2iHJy0KxIWeS5h9cnGU3lYohn1C27wmPxHMP5QTkzRT9iZi_ZCOVP6TOW_iTrkQWoa3bgiDgAB7gjGwiRrSvQbDcgJaBKoZqm0m-fO0PZt71ndoNMdk-JAxJFyJaT_yDfLOmWivZJTvSjCjJgswx35Z33C173jwhMveCGvqF_9W8w2pO1kKq3Q2G2fBR2ZpkaSol2w56BT2BHGWiGaIBl5RrcdikNuy0vfyrJt2qRf-L-9meUiOQv1zp6cFnoDDpF88Rp-Rq_sSruJYEVw5TapZMgg70Ea5YIv4GU6HGmBljmtRp8huSZJC0RHJVllQCEOjw4SznmjKuj2mQ-WjXT28Q9c2rV_zbURvDIYCG5Zdp4e9VHw6O1X8fiy_7j6Cv_cfyfZczk-hUvSA6nCsc-Vc2UXYQhl1YFWI8G1GDsduauU7or8byLOHLA25gPM1A2nYPwELeXNyx8LS_uWojMUxan-m8ARNkUg9yZgi5QI5gkD6mu9g_nHbv6pUqqrV6dDclUKX91gG7dxB6WNQ0"
}

Header Parameters

Content-Typestring

Authorizationstring

Body Parameters

refresh_tokenstring

Response

200

Object

Login response

Response Attributes

accessTokenstring

Api access token

refreshTokenstring

Api refresh token

curl --location 'https://globalr.com/api/v2/tokens/update' \
--header 'Content-Type: application/json' \
--header 'Authorization:  Bearer ACCESS_TOKEN' \
--data '{
  "refresh_token": "def502008951df3fe6f5a73433f29cdac34827a7160f34877088b0cec18cfd7a064f372da536f95d5554ed00e1b4149be5720c0c52e9e95b675cc7419df529008649dc30db95579796603eb20e8a8c81098ce5627e7c0600a6c6bc824536f1e8e2c4b2f33c4c810f18582072456aabddfb4de8802c2ac522bea72fdc184a358df39b4d54b7343803c1b2b4483089d4503a0b7e0fbb30120070e1c8f7d9986231b215aaf1c28447af9ad3f9e36524e32a2a1a763cf683e9d8df54ac20ff07b421547c2d4ed6804a539353a038dc2f43106034d6b6e6d5ae839d0d00b8346106047665a247fd70708ee15b0aedf58cd6221040681b320672e1713a2cbf539f3245a147c43f7825fe8a1cef80a36f52899ec44f3a6e7394d0ca82f70592209ed548099fd3a433a64cb0fd48407fa7cdd7425878eb28582fc327ea4ecc38100e3582292ef1d9a0a43fe98f0947874cf406f3d86ad4624030c1abba19bdd40ee47bd70527fd3a376a"
}'

{
  "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMTQ5ODQ3YjBlNGJkNTQ1MDAxZGJlZTAwYTZjMWEwNjZmOWU5NTY3MWQ0YmMwZTk1ZmJmMDY5MWQzYTE3MWQ4MTZhZTIzYjY4NWUzY2I3MDIiLCJpYXQiOjE2NDMwOTk4MzQsIm5iZiI6MTY0MzA5OTgzNCwiZXhwIjoxNjc0NjM1ODM0LCJzdWIiOiI1YjA1ZTgxMC1jZGExLTRhMzYtYjE0Ni1mODA5OGM5NGJkMzYiLCJzY29wZXMiOltdfQ.LoNc40NN5S4EaNraNS8Qy9FeADehW5qOXfuZYDC5LGw1bCjfeI6z5VXUwGpRvef2ktLILMA3mvSgomDuhACOfqTZ-D8Cd2QGyeoa2b2qo_lDyGjxX6QNlMrrBkkevufdsv0OhN08YI8S6E4MZe5IIVJ2iHJy0KxIWeS5h9cnGU3lYohn1C27wmPxHMP5QTkzRT9iZi_ZCOVP6TOW_iTrkQWoa3bgiDgAB7gjGwiRrSvQbDcgJaBKoZqm0m-fO0PZt71ndoNMdk-JAxJFyJaT_yDfLOmWivZJTvSjCjJgswx35Z33C173jwhMveCGvqF_9W8w2pO1kKq3Q2G2fBR2ZpkaSol2w56BT2BHGWiGaIBl5RrcdikNuy0vfyrJt2qRf-L-9meUiOQv1zp6cFnoDDpF88Rp-Rq_sSruJYEVw5TapZMgg70Ea5YIv4GU6HGmBljmtRp8huSZJC0RHJVllQCEOjw4SznmjKuj2mQ-WjXT28Q9c2rV_zbURvDIYCG5Zdp4e9VHw6O1X8fiy_7j6Cv_cfyfZczk-hUvSA6nCsc-Vc2UXYQhl1YFWI8G1GDsduauU7or8byLOHLA25gPM1A2nYPwELeXNyx8LS_uWojMUxan-m8ARNkUg9yZgi5QI5gkD6mu9g_nHbv6pUqqrV6dDclUKX91gG7dxB6WNQ0",
  "refreshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMTQ5ODQ3YjBlNGJkNTQ1MDAxZGJlZTAwYTZjMWEwNjZmOWU5NTY3MWQ0YmMwZTk1ZmJmMDY5MWQzYTE3MWQ4MTZhZTIzYjY4NWUzY2I3MDIiLCJpYXQiOjE2NDMwOTk4MzQsIm5iZiI6MTY0MzA5OTgzNCwiZXhwIjoxNjc0NjM1ODM0LCJzdWIiOiI1YjA1ZTgxMC1jZGExLTRhMzYtYjE0Ni1mODA5OGM5NGJkMzYiLCJzY29wZXMiOltdfQ.LoNc40NN5S4EaNraNS8Qy9FeADehW5qOXfuZYDC5LGw1bCjfeI6z5VXUwGpRvef2ktLILMA3mvSgomDuhACOfqTZ-D8Cd2QGyeoa2b2qo_lDyGjxX6QNlMrrBkkevufdsv0OhN08YI8S6E4MZe5IIVJ2iHJy0KxIWeS5h9cnGU3lYohn1C27wmPxHMP5QTkzRT9iZi_ZCOVP6TOW_iTrkQWoa3bgiDgAB7gjGwiRrSvQbDcgJaBKoZqm0m-fO0PZt71ndoNMdk-JAxJFyJaT_yDfLOmWivZJTvSjCjJgswx35Z33C173jwhMveCGvqF_9W8w2pO1kKq3Q2G2fBR2ZpkaSol2w56BT2BHGWiGaIBl5RrcdikNuy0vfyrJt2qRf-L-9meUiOQv1zp6cFnoDDpF88Rp-Rq_sSruJYEVw5TapZMgg70Ea5YIv4GU6HGmBljmtRp8huSZJC0RHJVllQCEOjw4SznmjKuj2mQ-WjXT28Q9c2rV_zbURvDIYCG5Zdp4e9VHw6O1X8fiy_7j6Cv_cfyfZczk-hUvSA6nCsc-Vc2UXYQhl1YFWI8G1GDsduauU7or8byLOHLA25gPM1A2nYPwELeXNyx8LS_uWojMUxan-m8ARNkUg9yZgi5QI5gkD6mu9g_nHbv6pUqqrV6dDclUKX91gG7dxB6WNQ0"
}

This API call returns detailed information about the user.

Header Parameters

Authorizationstring

Content-Typestring

Response

200

Object

Response Attributes

namestring

surenamestring

is_organisationboolean

organisation_namestring

countrystring

citystring

legal_addressstring

zipstring

sexstring

mobile_phonestring

phonestring

additional_emailstring

birthdaystring

balancenumber

1
2
3

curl --location 'https://globalr.com/api/v2/reseller_info' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Content-Type: application/json'

{
  "name": "Adria",
  "surename": "Frazier",
  "is_organisation": false,
  "organisation_name": "Company",
  "country": "US",
  "city": "New York",
  "legal_address": "Ap #322-1875 Pellentesque St.",
  "zip": "77255",
  "sex": "M",
  "mobile_phone": "12123593706",
  "phone": "12123593706",
  "additional_email": "morbi@yahoo.ca",
  "birthday": "1980-01-01",
  "balance": 1000
}

This API call is to logout the user.

Header Parameters

Authorizationstring

Content-Typestring

Response

200

Object

Response Attributes

messagestring

1
2
3

curl --location --request POST 'https://globalr.com/api/v2/logout' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Content-Type: application/json'

{
  "message": "Successfully logout"
}

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 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.

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

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'

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

Sections

Introduction

Language Box

cURL

Ruby

Python

PHP

Java

Node.js

Go

.NET

User

What made this section unhelpful for you?

Login

Header Parameters

Body Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Update Tokens

Header Parameters

Body Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

User information

Header Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Logout

Header Parameters

Response

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Domain

Modify Domain records

Transfer Domain

Prices

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response Attributes

What made this section unhelpful for you?

Response

What made this section unhelpful for you?

Response