Domain


Action: check

Checking if domain is available

Params Description Required
domains Check one or multiple domains if available Yes

{info} Multiple domains can be entered, separated by comma. As example: domain1.com,domain2.net,domain3.org.

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'check',
    'domains' => 'domain1.com,domain2.net,domain3.org',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "domainList": {
        "domain1.com": "busy",
        "domain2.net": "busy",
        "domain3.org": "busy"
    }
}

Action: whois

Extracting domain Whois information

Params Description Required
domain domain to whois Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'whois',
    'domain' => 'example.com',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "domain": 'example.com',
    "whois": 'WHOIS INFORMATION ABOUT THE DOMAIN',
}

Action: addcontact

Adding a contact for a domain. Exception here is .bg/.бг domain. Its using separate function addbgcontact

Params Description Required
name name of the domain contact Yes
company company of the domain contact No
email email of the domain contact Yes
address address of the domain contact Yes
city city of the domain contact Yes
country country of the domain contact, ISO 3166-1 alpha-2 format Yes
zipcode zip code of the domain contact Yes
phonecode phone code of the domain contact Yes
phone phone of the domain contact Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'addcontact',
    'domain' => 'example.com',
    'name' => 'Test name',
    'email' => 'test@test.com',
    'address' => 'Test address',
    'city' => 'Test',
    'country' => 'BG',
    'zipcode' => '1000',
    'phonecode' => '359',
    'phone' => '88 888 777',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "contactid": 4
}

Action: addbgcontact (Valid only for .BG/.БГ domains)

Adding a contact ONLY for a .bg/.бг domain. The types of request can be for a person or organisation.

Person

Params Description Required
contacttype The value can be organisation or person. In thise case should be "person". Yes
firstname_cyr first name of the domain contact in cyrilic Yes
firstname_lat first name of the domain contact in latin Yes
lastname_cyr last name of the domain contact in cyrilic Yes
lastname_lat last name of the domain contact in latin Yes
egn egn or lnch of the contact Yes
country_id Country ID of the contact. Can be obtailed from #nomenclatures Yes
settlement_id Settlement ID of the contact. Can be obtailed from #nomenclatures Yes
address_cyr address of the domain contact in Cyrilic Yes
address_lat address of the domain contact in Latin Yes
postcode post code of the domain contact Yes
phone phone of the domain contact Yes
email email address of the domain contact Yes

Organisation

Params Description Required
contacttype The value can be organisation or person. In thise case should be "organisation". Yes
companyname_cyr company name of the domain contact in cyrilic Yes
companyname_lat company name of the domain contact in latin Yes
company_id company id of the domain contact Yes
company_vat company vat of the domain contact No
companyowner_firstname_cyr Company owner first name of the domain contact in cyrilic Yes
companyowner_firstname_lat Company owner first name of the domain contact in latin Yes
companyowner_lastname_cyr Company owner last name of the domain contact in cyrilic Yes
companyowner_lastname_lat Company owner last name of the domain contact in latin Yes
companyowner_egn egn or lnch of the contact Yes
country_id Country ID of the contact. Can be obtailed from #nomenclatures Yes
settlement_id Settlement ID of the contact. Can be obtailed from #nomenclatures Yes
address_cyr address of the domain contact in Cyrilic Yes
address_lat address of the domain contact in Latin Yes
postcode post code of the domain contact Yes
phone phone of the domain contact Yes
email email address of the domain contact Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'addcontact',
    'domain' => 'example.com',
    'name' => 'Test name',
    'email' => 'test@test.com',
    'address' => 'Test address',
    'city' => 'Test',
    'country' => 'BG',
    'zipcode' => '1000',
    'phonecode' => '359',
    'phone' => '88 888 777',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "contactid": 3
}

Action: listcontacts

Getting all the contacts for the reseller.

{info} No special parameters are required

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'listcontacts',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "contactslist": {
        "1": {
            ".bg": "yes",
            "firstname_cyr": "Име",
            "firstname_lat": "Ime",
            "lastname_cyr": "Фамилия",
            "lastname_lat": "Familia",
            "egn": 12341234,
            "country_id": 1,
            "settlement_id": 2497,
            "settlement_name": "",
            "address_cyr": "Адрес на контакта",
            "address_lat": "Adres na kontakta",
            "postcode": "1000",
            "phone": "+359 831 12312 8",
            "email": "test@domain.com"
        },
        "2": {
            ".bg": "no",
            "name": "Ime Familia",
            "company": "NA",
            "email": "test@domain.com",
            "address": "Test address",
            "city": "Sofia",
            "country": "BG",
            "zipcode": "1000",
            "phonecode": "359",
            "phone": 12341234
        }
    }
}

{info} The id of the contact is the actual key of the returned json array

Action: nomenclatures (Valid only for creating a .BG/.БГ contact)

Nomenclatures are being used when creating a contact for .bg/.бг domain. Nomenclatures are basically a list of predefined values of countries, settlement areas, settlemengs and grounds.

{info} No special parameters are required

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'nomenclatures',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "nomenclatures": {
        "countries": {
            "1": {
                "countryBg": "БЪЛГАРИЯ",
                "countryEn": "BULGARIA"
            },
            "2": {
                "countryBg": "АВСТРАЛИЯ",
                "countryEn": "AUSTRALIA"
            }
            ..........
        }
    }
}

{info} The id of the contact is the actual key of the returned json array

Action: prices

Getting the domain prices for the reseller. Specific tld can be set (for example com, without dot or any other symbol).

Params Description Required
tld price for specific tld No

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'prices',
    'tld' => 'com', //If not set, prices for all the tlds will be displayed
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "prices": {
        ".com": {
            "register": "22.40",
            "transfer": "22.40",
            "renew": "22.40",
        }
    }
}

Action: request (Valid only for .BG/.БГ domains)

Before registering a .BG/.БГ domain, you must have a valid and processed request.

Params Description Required
domains supports multiple domains in the format domain1.bg,domain2.bg,domain3.bg Yes
contactid id of the domain contact. Can be obtained thru #addcontact or #addbgcontact (for .bg/.бг domains) Yes
ns1 name server #1 which will be applied in the domain request Yes
ns2 name server #2 which will be applied in the domain request Yes

{info} If you need to transfer some of the domains you can do pipeline symbol after the domain name. By default its 0, but you can set it to 1. As example - domain1.bg|1,domain2.bg,domain3.bg|1,domain4.bg

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'request',
    'contactid' => 1,
    'ns1' => 'ns1.jump.bg',
    'ns2' => 'ns2.jump.bg',
    'domains' => 'domain1.bg|1,domain2.bg,domain3.bg|1,domain4.bg',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "domains": [
        "domain1.bg",
        "domain2.bg",
        "domain3.bg",
        "domain4.bg"
    ],
    "queue": [ //If there are domains that are accepted, but are in the queue
        "domain5.bg",
        "domain6.bg"
    ],
    "invalid": [ //If there are invalid domains, the reason is mostly when there is already existing a request with those registration details
        "domain7.bg",
        "domain8.bg"
    ],
    "request_id": "123456",
    "registerbg_id": "123456", //same as request id, deprecated
    "pdf_url": "https://xxxxxxxxx/123456.pdf"
}

Action: register

If the registration completes, it will create an order with in your billing account along with invoice and it will use your account balance to pay the invoice. The registration should complete automatically unless something goes wrong.

{info} This is the step where your billing account will be charged, if successful

Params Description Required
domain The domain name you wish to register Yes
reg_period Registration period in years. Can be 1 - 9. Yes
request_id Request ID, only required for .BG/.БГ domains. Request ID of the .BG domain. Can be obtained thru list method. Yes
contact_id Request ID, only required for NON .BG/.БГ domains. Id of the contact. Can be obtained thru #listcontacts. Yes
ns1 required only for non .bg/.бг domain name server #1 which will be applied in the domain request Yes
ns2 required only for non .bg/.бг domain name server #2 which will be applied in the domain request Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'register',
    'domain' => 'example.com',
    'reg_period' => 1, //The domain is being registered for 1 year
    'ns1' => 'ns1.jump.bg',
    'ns2' => 'ns2.jump.bg',
    'contact_id' => 4, //Only required when registering a Non .bg/.бг domain
    'request_id' => 123456, //Only required when registering a .bg/.бг domain
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "price": 10.90,
    "domain": 'example.com',
    "id": 8500,
    "invoice_url": 'https://xxxxxxxxxxxxxxxxx/viewinvoice.php?id=1234'
}

Action: transfer

If the transfer completes it will create an order with your jump.bg account along with invoice and it will use your account balance to pay the invoice. The transfer should complete automatically unless something goes wrong.

Params Description Required
domain The domain name you wish to register Yes
epp only required for Non .BG/.БГ domains Epp code or transfer key if the domain supports such Yes
request_id Request ID, only required for .BG/.БГ domains. Request ID of the .BG domain. Can be obtained thru list method. Yes
contact_id Contact ID, only required for NON .BG/.БГ domains. Id of the contact. Can be obtained thru #listcontacts. Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'transfer',
    'domain' => 'example.com',
    'epp' => 'IO9hBNdsaD#hdas', //The EPP code for transfer. The domain must also be unlocked for transfer. This is required for Non .BG/.БГ domain
    'contact_id' => 4, //Only required when registering a Non .bg/.бг domain
    'request_id' => 123456, //Only required when registering a .bg/.бг domain
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "price": 10.90,
    "domain": 'example.com',
    "id": 8500,
    "invoice_url": 'https://xxxxxxxxxxxxxxxxx/viewinvoice.php?id=1234'
}

Action: renew

Renewing the domain. Can be renewed at any point. It will throw an error if the domain is already being invoiced in your Jump.BG profile. You have to pay the already generated invoice. If the domain is invoiced with other domains / services, contact us and we will split the invoice.

Params Description Required
domainid Domain Id of the domain you wish to renew. Can be obtained thru list command Yes
renew_period The period for renewal in years. Can be 1 - 9 Yes
delete_invoice Delete the invoice, if a renewal invoice alrexy exists. Can be 1 or 0 No

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'renew',
    'domainid' => 1234,
    'renew_period' => 1,
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "price": 10.90,
    "domain": 'example.com',
    "id": 8500,
    "invoice_url": 'https://xxxxxxxxxxxxxxxxx/viewinvoice.php?id=1234'
}

Action: setns

Set nameservers to already active domain. Additional parameters:

Params Description Required
domainid Domain Id of the domain you wish to change. Can be obtained thru list command Yes
ns1 Nameserver #1 Yes
ns2 Nameserver #2 Yes
ns3 Nameserver #3 No
ns4 Nameserver #4 No
ns5 Nameserver #5 No

{info} If you are trying to set child name servers to a .bg/.бг domain you need to set ipv4 address divided by pipeline symbol. For example: you have the domain example.bg and you need to set name servers ns1.example.bg and ns2.example.bg. In this case the records should be "ns1.example.bg|12.13.1.18" and "ns2.example.bg|4.4.4.4" where the ipaddresses are the ones that are on the dns servers itself.

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'setns',
    'ns1' => 'ns1.jump.bg',
    'ns2' => 'ns2.jump.bg',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "domain": 'example.com'
}

Action: getns

Get nameservers to already active domain. Additional parameters:

Params Description Required
domainid Domain Id of the domain you wish to get. Can be obtained thru list command Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'getns',
    'domainid' => 1234,
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "domain": 'example.com'
    "ns1": 'ns1.jump.bg',
    "ns2": 'ns2.jump.bg'
}

Action: list

Lists domains by different parameters.

Params Description Required
domain Exact domain name. REQUIRED WHEN NO FROMDATE AND TODATE IS ENTERED
fromdate From which date to display results - YYYY-MM-DD, REQUIRED WHEN NO DOMAIN IS ENTERED
todate To which date to display results - YYYY-MM-DD, REQUIRED WHEN NO DOMAIN IS ENTERED
limit How many entries to display. Yes

Request Parameters

$curl_url = 'https://api.jump.bg/api.php';

$curl_post = [
    'api_userid' => 'API_USER_ID',
    'api_password' => 'API_PASSWORD',
    'type' => 'domain',
    'action' => 'list',
    'fromdate' => '2021-07-20',
    'todate' => '2021-08-03',
    'limit' => '5',
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $curl_url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => $curl_post,
]);

$response = curl_exec($curl);
curl_close($curl);

var_dump($response); //It will return the result in JSON

Response Parameters:

{
    "success": 1,
    "list": [
        {
            "domain": "domain1.com", //Name of the domain
            "id": 1234, // Id of the domain
            "status": "Active", //Status of the domain
            "type": "Register", //Register or Transfer
            "reg_date": "2021-10-07", //When is it registered
            "exp_date": "0000-00-00" // Expiration date
        },
        {
            "domain": "domain2.bg", //Name of the domain
            "id": 4321, // Id of the domain
            "request_id": 123456, //Request Id, this will be used only for .BG/.БГ domains
            "multiple": 0, //If the domain is part of a multiple domains request, only used for .BG/.БГ domains
            "processed": 0, //If the documents for the request are processed, only used for .BG/.БГ domains
            "queue": 0, //If the domains is in the queue for registering, only used for .BG/.БГ domains
            "ordered": 0, //If the domain is actually registered / transfered after the request, only used for .BG/.БГ domains
            "transfer": 0, //If its a transfer, only used for .BG/.БГ domains
            "date_request": "2021-07-31 07:58:57", //Date of the request, only used for .BG/.БГ domains
            "date_reg": "0000-00-00", //When is it registered
            "exp_date": "0000-00-00" // Expiration date
            "pdf_url": "https://xxxxxxxxx/domain2.bg-123456.pdf" //PDF file of the request, only used for .BG/.БГ domains
        }
    ]
}

.BG/.БГ Domain flow

Lets take a simple domain registration:

  1. Obtain country_id and settlement_id from nomenclatures directive.
  2. Add contact with #addbgcontact using the country and settlement ids from the previous step.
  3. Create a #request with the contact id that was created. A pdf file will be generated that must be signed by the pointed contact. The file can be signed with digital certificate or in person.
  4. After the request is successful, you can #register the domain with the created request id. This step will register the domain, add the order to the reseller's account, create and pay the invoice from the user's balance.
  5. When the domain is registered in our system and we receive the signed pdf request, we will activate the domain at the main registrar.